A task to send SMTP email. This task can send mail using either plain text, UU encoding, or MIME format mail, depending on what is available. Attachments may be sent using nested fileset elements.

SMTP Eメールを送るタスク。 このタスクは、利用可能なものに依存して、 プレーンテキスト、UUエンコード、MIME形式のメールのいずれかを用いてめーるを送ることができます。 添付ファイルは fileset 要素をネストすることにより送ります。

Note: This task may depend on external libraries that are not included in the Ant distribution. See Library Dependencies for more information.

注意: このタスクは、Ant のディストリビューションには含まれていない外部ライブラリに依存します。 詳しくは、 ライブラリ依存関係をご覧ください。



Attribute Description Required
from Email address of sender. Either a from attribute, or a <from> element.
tolist Comma-separated list of recipients. At least one of these, or the equivalent elements.
cclist Comma-separated list of recipients to carbon copy
bcclist Comma-separated list of recipients to carbon copy
message Message to send in the body of the email. One of these or a <message> element.
messagefile File to send as the body of the email. Property values in the file will be expanded.
messagemimetype The content type of the message. The default is text/plain. No
files Files to send as attachments to the email. Separate multiple file names using a comma. You can also use <fileset> elements to specify files. No
failonerror flag to indicate whether to halt the build on any error. The default value is true. No.
includefilenames Include filename(s) before file contents. Valid only when the plain encoding is used. The default value is false. No
mailhost Host name of the SMTP server. The default value is localhost. No
mailport TCP port of the SMTP server. The default value is 25. No
encoding Specifies the encoding to use for the content of the email. Values are mime, uu, plain, or auto. The default value is auto. No
subject Email subject line. No
属性 説明 必須
from 送信者のメールアドレス from属性か、<from>要素のいずれか
tolist カンマで区切られた受取人のリスト 少なくともこれら、あるいはその等価な要素のうちの一つ
cclist カンマで区切られたカーボンコピーのための受取人のリスト
bcclist カンマで区切られたカーボンコピーのための受取人のリスト
message Eメールの本文として送るメッセージ これらのうち一つか、あるいは、 <message>要素
messagefile Eメールの本文として送るファイル。 ファイル中のプロパティの値は展開されます。
messagemimetype メッセージのコンテンツタイプ。 デフォルトはtext/plain No
files Eメールで添付ファイルとして送るファイル。 複数のファイルはカンマを使って区切ります。 ファイルを指定するには、 <fileset>要素も使えます。 No
failonerror 何らかのエラーでビルドを停止させるかを示すフラグ。 デフォルトはtrue No.
includefilenames ファイルコンテンツのまえに幾つかのファイルを挿入します。 plainエンコーディングが使われている時のみ有効です。 デフォルト値はfalseです。 No
mailhost SMTPサーバーのホスト名。 デフォルト値はlocalhost No
mailport SMTPサーバーのTCPポート。 デフォルト値は25 No
encoding Eメールのコンテンツで使われるエンコーディングを指定します。 値は mimeuuplainあるいは、 autoです。 デフォルト値はauto No
subject Eメールの件名の行 No

Parameters specified as nested elements


to / cc / bcc / from

Adds an email address element. It takes the following attributes:


Attribute Description Required
name The display name for the address. No
address The email address. Yes
属性 説明 必須
name アドレスの表示名 No
address Eメールアドレス Yes


Specifies the message to include in the email body. It takes the following attributes:

Eメールの本文に含めるメッセージを指定します。 次の属性を取ります:

Attribute Description Required
src The file to use as the message. No
mimetype The content type to use for the message. No
属性 説明 必須
src メッセージとして使われるファイル No
mimetype メッセージに使われるコンテンツタイプ No

If the src attribute is not specified, then text can be added inside the <message> element. Property expansion will occur in the message, whether it is specified as an external file or as text within the <message> element.

src 属性が指定されない場合、 テキストは<message>要素により加えることができます。 外部ファイルとして指定されても、 <message>要素の中のテキストでも、どちらでも、 messageの中でプロパティの展開は行われます。


<mail from="me"
      subject="Results of nightly build"
      files="build.log" />

Sends an email from me to you with a subject of Results of nightly build and includes the contents of the file build.log in the body of the message.

Sends an email from me から you へ、 Results of nightly buildという件名で、 build.logファイルの中身をメッセージの本文に入れて、 メールを送ります。

<mail mailhost="" mailport="1025" subject="Test build">
  <from name="">
  <to name="">
  <message>The ${buildname} nightly build has completed</message>
  <fileset dir="dist">
    <includes name="**/*.zip"/>

Sends an eMail from to with a subject of Test Build and attaches any zip files from the dist directory.  The task will attempt to use JavaMail and fall back to UU encoding or no encoding in that order depending on what support classes are available. ${buildname} will be replaced with the buildname property's value. から へ、 Test Build という件名で、 ディレクトリ dist の下の全ての zip ファイルを添付してメールを送ります。 このタスクは JavaMail を使い、 どのサポートするクラスが利用可能かその順序に依存して、UUエンコーディングあるいはエンコード無しとなります。 ${buildname}buildnameプロパティの値で置き換えられます。

Copyright © 2000-2002 Apache Software Foundation. All rights Reserved.

[訳注:これは漆島賢二が翻訳しました。日本語訳に対するコメントがあれば report@jajakarta.orgに送ってください]