IMAPトランスポート・プロバイダは、IMAPメールボックスからメッセージを受信することやIMAPメールボックスに javax.mail APIを使ってSSL（IMAPs）で接続します。

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

org.mule.providers.email.ImapConnector。

IMAPコネクタ・プロパティ

サーバ認証 ホスト名, ポート, ユーザ認証はimap://エンドポイントに設定します。ポートで指定されていない場合は、デフォルト・ポートが利用されます。

IMAPSコネクタ・プロパティ

IMAPsコネクタは javax.mail APIを使ってSSL上でのIMAPをサポートします。IMAPコネクタの全てのプロパティをサポートする他にSSL接続用に以下のプロパティもサポートします。

IMAPsコネクタはデフォルトとしてポート993を利用します。

IMAP(s)エンドポイント

IMAPエンドポイントにはIMAPメールボックスに接続する情報を設定します。IMAP URIの文法は以下の通りです：

imap://<ユーザ名:パスワード>@<IMAPサーバ>[:ポート]/<メール・フォルダ>[?パラメータ]

IMAPsも同じ文法です：

imaps://<ユーザ名:パスワード>@<IMAPサーバ>[:ポート]/<メール・フォルダ>[?パラメータ]

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

例：

imaps://joe:123456@imap.mycompany.com/mail?checkFrequency=30000

上の設定は imap.mycompany.com サーバにユーザ名 joe 、パスワード 123456　で（デフォルトをIMAPsを利用して）ログインして、 mail フォルダを開きます。３０秒毎に新規メールを確認します。

エンドポイントにその他のプロパティを設定する場合は、URIのパラメータに設定することもできますが、読みやすくするためにエンドポイントのプロパティとして設定することを推奨します。

<endpoint address="imaps://ユーザ名:パスワード@imap.mail.com/mail">
    <properties>
        <property name="checkFrequency" value="120000"/>
        <property name="trustStore" value="./trustore"/>
        <property name="trustStorePassword" value="trustNoOne"/>
    </properties>
</endpoint>

フィルタ

不要なメッセージを排除するために、エンドポイントにフィルタを設定することができます。Mailトランスポート・プロバイダは複数のEmailファルタを用意しています。それらを直接利用することも、継承してカスタム・フィルタ・ルールを定義することもできます。

フィルタの設定

下の例は件名が [mule] で始まるメールのみを受信します：

<endpoint address="imaps://username:password@imap.mail.com/lists">
    <filter className="org.mule.providers.email.filters.MailSubjectRegExFilter"
        pattern="\\[mule\\](.*)"/>
    <properties>
        <property name="checkFrequency" value="120000"/>
        <property name="trustStore" value="./trustore"/>
        <property name="trustStorePassword" value="trustNoOne"/>
    </properties>
</endpoint>

トランスフォーマー

javax.mail.Message をESB Muleイベント・ペイロードに変換するのを便利にするために、Emailトランスポートには複数のトランスフォーマーが用意されています。トランスフォーマーはメッセージの本文とプロパティ（ヘッダを含む）を抽出し、添付ファイルも処理します。カスタム・トランスフォーマーを作成する場合は全て新規に開発せず、これらの既存トランスフォーマーを継承することを推奨します。