このオブジェクトモジュールはメールの解析と、 解析されたデータ構造へのさまざまな操作手段を提供しています。 もう少し詳しく説明すると、このモジュールはメールを解析し、 (multipart でない場合) header -> body (multipart の場合) header -> preamble -> part1 -> part2 -> trailor のようにオブジェクトが数珠つなぎとなったデータ構造を作ります。ちなみに 鎖と鎖の間は double link list です。Mail::Message のクラスはこのような データ構造に対して、さまざまな操作を行なうメソッドを提供しています。 この鎖の部分部分それぞれが Mail::Message オブジェクトです。つまり一通 のメールはメールヘッダから始まるオブジェクトの鎖として表現されます。 header は Mail::Message のタイプが text/rfc822-headers で、 data が Mail::Header オブジェクトになります。 一方 part1 は text/plain で、 data 部分が文字列へのリファレンスです。 参照: Mail::Message モジュールのマニュアル parse() メソッドは引数で与えられたファイル(名)かファイルディスクリプタ に対しメッセージの解析をします。 data_type_list() は鎖の列の情報を返します。情報は ARRAY REFERENCE の形 で返されます。例えば MIME/Multipart は次の表現されています。 type[ 1]: text/rfc822-headers | multipart/mixed type[ 2]: multipart/mixed | multipart/mixed type[ 3]: multipart.preamble | multipart/mixed type[ 4]: multipart.delimiter | multipart/mixed type[ 5]: text/plain | multipart/mixed type[ 6]: multipart.delimiter | multipart/mixed type[ 7]: image/gif | multipart/mixed type[ 8]: multipart.close-delimiter | multipart/mixed type[ 9]: text/plain | multipart/mixed 真中の列がオブジェクトの鎖を表しています。 右端は全体の mime type です。 new() メソッドは通常、新しいメッセージを作る際に使われます。 MIME/multipart 専用のためのメソッドもあります。 build_mime_multipart_chain($args) parse_and_build_mime_multipart_chain($args) build_mime_header($args) これらのメソッドを直接呼び出すことは実際ないので、 これらは private に移行するかもしれません。 だから、とりえあずこれらは使わないでください。 しかしながら、MIME/mulitpart の作成には Mail::Message::Compose クラスがあります。 実のところ、このクラスの実態は MIME::Lite そのものです :-) dup_header() メソッドは RFC822 型のメッセージのヘッダ部分のみのコピーを行ないます。 メールの本体の部分はそのままです。 複製されたヘッダオブジェクトからのリンクは メールの本体です。 |<--------------- メール本体 -------------> header0 ----> part1 -> part2 -> ... A | dup_header0 --- whole_message_header() はメッセージの中のヘッダ部分のオブジェクトを返します。 文字列ではないことに注意して下さい。 __head_message() は鎖の先頭のオブジェクトを返します。 __last_message() は鎖の最後のオブジェクトを返します。 そのため、通常、図の header オブジェクトを返すことになりますので、 多くの場合 whole_message_header() と等価です。 header_data_type() はメール全体のタイプ(文字列)を返します。 つまり、このメッセージは単なるテキストなのかマルチパートなのか？などを 教えてくれます。 以下では、このような鎖を例にとるとします。 (multipart でない場合) header -> body (multipart の場合) header -> preamble -> part1 -> part2 -> trailor まず header_data_type() はメール全体のタイプ(文字列)を返します。 つまり、このメッセージは単なるテキストなのかマルチパートなのか？などを 教えてくれます。 つまり header の Content-Type で得られる情報です。 whole_message_body() メソッドは body ないしは part1 の部分のオブジェクトを返します。 whole_message_body_head() メソッドも同じ操作をします。 __head_message() は鎖の先頭のオブジェクトを返します。 __last_message() は鎖の最後のオブジェクトを返します。 そのため、通常、図の header オブジェクトを返すことになりますので、 多くの場合 whole_message_header() と等価です。 __last_message() は鎖の最後の部分なのでメッセージ本文の最後になります。 find_first_plaintext_message($args) は 鎖の中で最初の plain/text タイプの Mail::Message オブジェクトを返します。 フィルタリングでは最初の plain/text タイプのメッセージ部分に着目することが多いので この関数を使うと便利です。 find() メソッドは Mail::Message の特定のタイプを探し、 最初に見つけたオブジェクトを返します。 print() メソッドは文字どおり print です。 通常は引数で出力するファイルディスクリプタを渡して下さい。 print() には CRLF なのか LF なのかを指定する mode という概念があります。 このために set_print_mode(mode) および reset_print_mode() というメソッドがあります。 通常は raw で、SMTP の時だけは smtp を指定して下さい。 size() はオブジェクトのサイズを返します。 メール全体ではありません。 header_size() や body_size() を使うと、ヘッダやメール本文全体の長さを教えてくれます。 is_empty() はオブジェクトが空かどうかを教えてくれます。 envelope_sender() は メールの送信者情報(文字列)を返します。 data_type() は Mail::Message オブジェクトのタイプ(文字列)を返します。 これは、メール全体のタイプ（マルチパートとか text/plain) どではなく、鎖の各部分のオブジェクトのタイプであることに注意して下さい。 encoding_mechanism() は Mail::Message オブジェクトのエンコーディングメカニズム(文字列)を返します。 エンコーディングされていないなら undef が返ります。 これは、メール全体のタイプ（マルチパートとか text/plain) ではなく、鎖の各部分のオブジェクトのタイプであることに注意して下さい。 num_paragraph() は その Mail::Message オブジェクトの中に 何個のパラグラフがあるか(数字)を返します。 nth_paragraph(数字) は 数字番目のパラグラフの内容を文字列として返します。 例えば、一番目のパラグラフは 0 ではなく 1 と指定して下さい。 header() は MIME/multipart の各ブロックにあるヘッダ部分を返します。 data() は、データの部分です。 それぞれ message_fields($size) message_text($size) の alias です。 Mail::Message モジュールの(英語)マニュアル