SMTPトランスポート・プロバイダは、 javax.mail APIを使ってメッセージをSMTP及びSMTPs(セキュア）で送信する場合に使うことができあｍす。
CC/BCC/ReplyToアドレス, 添付, カスタム・ヘッダ, カスタム認証をサポートしています。なお、 javax.mail.Message 変換のサポートもあります。

このプロバイダのJavadocは ここ にあります。

SMTPコネクタ・プロパティ

サーバ認証 ホスト, ポート, ユーザ認証情報はsmtp://エンドポイントに設定します。コネクタに設定された他プロパティは、エンドポイントにそのプロパティが設定されていない場合にデフォルト値として利用されます。

SMTPsコネクタ・プロパティ

The Smtps Connector enables Smtp over SSL using the javax.mail APIs. It supports all the properties of the Smtp connector and has some additional properties for setting up an SSL connection.

SMTPsコネクタはデフォルト・ポートとして465を使います。

SMTP(s)エンドポイント

SMTPエンドポイントは、SMTPサーバとSTMPエンドポイントから送信されたメッセージの宛先を指定します。SMTP URIは以下のように記述します：

smtp://[ユーザ名:パスワード@]<SMTPサーバ>[:ポート]?address=<宛先>

SMTPsの場合も同じです：

smtps://[ユーザ名:パスワード@]<SMTPサーバ>[:ポート]?address=<宛先>

特殊文字の利用 ユーザ名及びパスワードにURIの文字として利用が禁止されている文字が含まれている場合があります。この場合は、webブラウザで対応しているエスケープ文字を代わりに使ってください。 例： ユーザ名 user@mule の代わりに user%40mule を使ってください。

例：

smtp://muletestbox:123456@smtp.mail.yahoo.co.uk?address=dave@mycomany.com

上の例は、SMTPサーバsmtp.mail.yahoo.co.uk（デフォルトSMTPポートを使って）、宛先 dave@mycomany.com にメールを送ります。ユーザ名「muletestbox 」、パスワード「123456」を使ってSMTPサーバに接続をします。

件名 （subject）や 差出人 （fromAddress）も設定すると思います。これらもURIのパラメータに設定することができますが、保守のために読みやすくするために、エンドポイントのプロパティに設定することを推奨します。

<endpoint address="smtp://muletestbox:123456@smtp.mail.yahoo.co.uk?
                              address=dave@mycomany.com">
    <properties>
        <property name="fromAddress" value="steve@mycompany.com"/>
        <property name="ccAddresses" value="john@mycompany.com,rex@foo.com"/>
        <property name="subject" value="Please verify your ebay account details"/>
    </properties>
</endpoint>

これまでは、全ての情報をエンドポイントに設定したたてめに値は静的でしたが、MuleMessageに以下のプロパティを利用して動的にSMTPメッセージを設定することもできます。これらのプロパティはエンドポイントのプロパティを上書きします。

宛先を必ず動的に設定する場合は、SMTPエンドポイントの address パラメータを省略することができます。

トランスフォーマー

EmailトランスポートはObject型のペイロードを javax.mail.Message に変換するためのトランスフォーマーを用意しています。トランスフォーマーは上に書かれたルールに従っている他に添付にも対応しています。カスタムのトランスフォーマーが必要な場合は、一から作成せず、これらを継承することを推奨します。