31.19. Spring Boot 自動設定
Spring Boot で imap を使用する場合は、次の Maven 依存関係を使用して自動設定をサポートしてください。
コンポーネントは、以下に記載される 50 のオプションをサポートします。
| Name | 説明 | デフォルト | タイプ |
|---|---|---|---|
| camel.component.mail.additional-java-mail-properties | 他のすべてのオプションに基づいて設定されたデフォルトプロパティーを追加/オーバーライドする追加の Java メールプロパティーを設定します。これは、いくつかの特別なオプションを追加する必要があるが、他のオプションはそのままにしておきたい場合に便利です。オプションは java.util.Properties タイプです。 | プロパティー | |
| camel.component.mail.alternative-body-header | 代替電子メール本文を含む IN メッセージヘッダーのキーを指定します。たとえば、メールを text/html 形式で送信し、HTML 以外のメールクライアントに代替メール本文を提供する場合は、このキーをヘッダーとして使用して代替メール本文を設定します。 | CamelMailAlternativeBody | String |
| camel.component.mail.attachments-content-transfer-encoding-resolver | カスタムの AttachmentsContentTransferEncodingResolver を使用して、添付ファイルに使用する content-type-encoding を解決するには。オプションは org.apache.camel.component.mail.AttachmentsContentTransferEncodingResolver タイプです。 | AttachmentsContentTransferEncodingResolver | |
| camel.component.mail.authenticator | ログインのオーセンティケーター。設定すると、パスワードとユーザー名は無視されます。有効期限が切れる可能性があるため、動的に読み取る必要があるトークンに使用できます。オプションは org.apache.camel.component.mail.MailAuthenticator タイプです。 | MailAuthenticator | |
| camel.component.mail.autowired-enabled | 自動ワイヤリングが有効になっているかどうか。これは、コンポーネントで設定される一致するタイプのインスタンスが 1 つあるかどうかを検出するためにレジストリーを検索することで、自動ワイアリングオプションに使用されます (オプションは自動ワイアとマーク付けされる必要があります)。これは、JDBC データソース、JMS 接続ファクトリー、AWS クライアントなどの自動設定に使用できます。 | true | ブール値 |
| camel.component.mail.bcc | BCC メールアドレスを設定します。複数の電子メールアドレスはコンマで区切ります。 | String | |
| camel.component.mail.bridge-error-handler | consumer の Camel ルーティングエラーハンドラーへのブリッジを許可します。よって、consumer が受信メッセージなどの取得を試行している間に発生した例外は、メッセージとして処理され、ルーティングエラーハンドラーによって処理されます。デフォルトでは、consumer は org.apache.camel.spi.ExceptionHandler を使用して例外に対応し、WARN または ERROR レベルでログに記録され、無視されます。 | false | ブール値 |
| camel.component.mail.cc | CC メールアドレスを設定します。複数の電子メールアドレスはコンマで区切ります。 | String | |
| camel.component.mail.close-folder | ポーリング後に consumer がフォルダーを閉じる必要があるかどうか。このオプションを false に設定し、disconnect=false も設定すると、consumer はポーリング間でフォルダーを開いたままにします。 | true | ブール値 |
| camel.component.mail.configuration | メール設定を設定します。オプションは org.apache.camel.component.mail.MailConfiguration タイプです。 | MailConfiguration | |
| camel.component.mail.connection-timeout | ミリ秒単位の接続タイムアウト。 | 30000 | Integer |
| camel.component.mail.content-type | メールメッセージのコンテンツタイプ。HTML メールには text/html を使用します。 | text/plain | String |
| camel.component.mail.content-type-resolver | 添付の Content-Type を決定するリゾルバー。オプションは org.apache.camel.component.mail.ContentTypeResolver タイプです。 | ContentTypeResolver | |
| camel.component.mail.copy-to | メールメッセージを処理した後、指定された名前のメールフォルダーにコピーできます。キー copyTo を含むヘッダーを使用して、この設定値をオーバーライドできます。これにより、実行時に設定されたフォルダー名にメッセージをコピーできます。 | String | |
| camel.component.mail.debug-mode | 基礎となるメールフレームワークでデバッグモードを有効にします。SUN メールフレームワークは、デフォルトでデバッグメッセージを System.out に記録します。 | false | ブール値 |
| camel.component.mail.decode-filename | true に設定すると、MimeUtility.decodeText メソッドを使用してファイル名がデコードされます。これは、JVM システムプロパティー mail.mime.encodefilename の設定に似ています。 | false | ブール値 |
| camel.component.mail.delete | 処理後にメッセージを削除します。これは、メールメッセージに DELETED フラグを設定することによって行われます。false の場合、代わりに SEEN フラグが設定されます。Camel 2.10 では、メールを削除するかどうかを決定するキー delete でヘッダーを設定することにより、この設定オプションをオーバーライドできます。 | false | ブール値 |
| camel.component.mail.disconnect | ポーリング後に consumer を切断するかどうか。有効にすると、各ポーリングで Camel が強制的に接続されます。 | false | ブール値 |
| camel.component.mail.enabled | mail コンポーネントの自動設定を有効にするかどうか。これはデフォルトで有効になっています。 | ブール値 | |
| camel.component.mail.fetch-size | ポーリング中に消費するメッセージの最大数を設定します。これは、メールボックスフォルダーに大量のメッセージが含まれている場合に、メールサーバーの過負荷を回避するために使用できます。デフォルト値の -1 は、フェッチサイズがなく、すべてのメッセージが消費されることを意味します。値を 0 に設定するのは、Camel がメッセージをまったく消費しない特殊なケースです。 | -1 | Integer |
| camel.component.mail.folder-name | ポーリングするフォルダー。 | INBOX | String |
| camel.component.mail.from | 差出人の電子メールアドレス。 | camel@localhost | String |
| camel.component.mail.handle-failed-message | mail consumer が特定のメールメッセージを取得できない場合、このオプションを使用すると、consumer のエラーハンドラーによって発生した例外を処理できます。consumer でブリッジエラーハンドラーを有効にすると、代わりに Camel ルーティングエラーハンドラーが例外を処理できます。デフォルトの動作では、consumer が例外を出力し、バッチからのメールは Camel によってルーティングできません。 | false | ブール値 |
| camel.component.mail.header-filter-strategy | カスタムの org.apache.camel.spi.HeaderFilterStrategy を使用して、Camel メッセージとの間でヘッダーをフィルターします。このオプションは org.apache.camel.spi.HeaderFilterStrategy タイプです。 | HeaderFilterStrategy | |
| camel.component.mail.ignore-unsupported-charset | メール送信時にローカル JVM でサポートされていない文字セットを Camel が無視できるようにするオプション。文字セットがサポートされていない場合は、charset=XXX (XXX はサポートされていない文字セットを表す) が content-type から削除され、代わりにプラットフォームのデフォルトに依存します。 | false | ブール値 |
| camel.component.mail.ignore-uri-scheme | メール送信時にローカル JVM でサポートされていない文字セットを Camel が無視できるようにするオプション。文字セットがサポートされていない場合は、charset=XXX (XXX はサポートされていない文字セットを表す) が content-type から削除され、代わりにプラットフォームのデフォルトに依存します。 | false | ブール値 |
| camel.component.mail.java-mail-properties | Java メールオプションを設定します。デフォルトのプロパティーをすべてクリアし、このメソッドに提供されているプロパティーのみを使用します。オプションは java.util.Properties タイプです。 | プロパティー | |
| camel.component.mail.java-mail-sender | メールの送信にカスタム org.apache.camel.component.mail.JavaMailSender を使用するには。オプションは org.apache.camel.component.mail.JavaMailSender タイプです。 | JavaMailSender | |
| camel.component.mail.lazy-start-producer | 最初のメッセージで producer をレイジーに起動すべきかどうか。レイジーに起動することで、起動時に producer が失敗し、それによりルートが失敗する可能性がある状況で、CamelContext およびルートの起動を許可します。レイジーな起動を延期すると、Camel のルーティングエラーハンドラー経由でメッセージのルーティング中に起動の失敗を処理できます。最初のメッセージが処理されるときに、producer の作成および起動に若干時間がかかり、合計処理時間が長くなる可能性があることに注意してください。 | false | ブール値 |
| camel.component.mail.map-mail-message | Camel が受信したメールメッセージを Camel の本文/ヘッダー/添付ファイルにマップするかどうかを指定します。true に設定すると、メールメッセージの本文は Camel IN メッセージの本文にマップされ、メールヘッダーは IN ヘッダーにマップされ、添付ファイルは Camel IN 添付メッセージにマップされます。このオプションが false に設定されている場合、IN メッセージには生の javax.mail.Message が含まれます。exchange.getIn ().getBody (javax.mail.Message.class) を呼び出して、この生のメッセージを取得できます。 | true | ブール値 |
| camel.component.mail.mime-decode-headers | このオプションは、メールヘッダーの透過的な MIME デコードとデプロイメントを有効にします。 | false | ブール値 |
| camel.component.mail.move-to | メールメッセージを処理した後、指定された名前のメールフォルダーに移動できます。キー moveTo を含むヘッダーを使用して、この設定値をオーバーライドできます。これにより、実行時に設定されたフォルダー名にメッセージを移動できます。 | String | |
| camel.component.mail.password | ログイン用のパスワード。setAuthenticator (MailAuthenticator) も参照してください。 | String | |
| camel.component.mail.peek | メールメッセージを処理する前に、javax.mail.Message をピークとしてマークします。これは、IMAPMessage メッセージタイプにのみ適用されます。peek を使用すると、メールはメールサーバー上で SEEN としてマークされません。これにより、Camel でエラー処理が発生した場合にメールメッセージをロールバックできます。 | true | ブール値 |
| camel.component.mail.reply-to | Reply-To 受信者 (応答メールの受信者)。複数のメールアドレスはコンマで区切ります。 | String | |
| camel.component.mail.session | camel がすべてのメールインタラクションに使用するメールセッションを指定します。メールセッションが JavaEE コンテナーなどの他のリソースによって作成および管理されるシナリオで役立ちます。カスタムメールセッションを使用する場合、メールセッションのホスト名とポートが使用されます (セッションで設定されている場合)。オプションは javax.mail.Session タイプです。 | Session | |
| camel.component.mail.skip-failed-message | mail consumer が特定のメールメッセージを取得できない場合、このオプションを使用すると、メッセージをスキップして次のメールメッセージの取得に進むことができます。デフォルトの動作では、consumer が例外を出力し、バッチからのメールは Camel によってルーティングできません。 | false | ブール値 |
| camel.component.mail.ssl-context-parameters | SSLContextParameters を使用してセキュリティーを設定する場合。オプションは org.apache.camel.support.jsse.SSLContextParameters タイプです。 | SSLContextParameters | |
| camel.component.mail.subject | 送信されるメッセージの件名。注: ヘッダーに件名を設定すると、このオプションよりも優先されます。 | String | |
| camel.component.mail.to | 宛先メールアドレスを設定します。複数の電子メールアドレスはコンマで区切ります。 | String | |
| camel.component.mail.unseen | 未読メールのみで制限するかどうか。 | true | Boolean |
| camel.component.mail.use-global-ssl-context-parameters | グローバル SSL コンテキストパラメーターの使用を有効にします。 | false | ブール値 |
| camel.component.mail.use-inline-attachments | ディスポジションインラインまたは添付ファイルを使用するかどうか。 | false | ブール値 |
| camel.component.mail.username | ログイン用のユーザー名。setAuthenticator (MailAuthenticator) も参照してください。 | String | |
| camel.dataformat.mime-multipart.binary-content | MIME マルチパートのバイナリーパートのコンテンツがバイナリー (true) か Base-64 エンコード (false) かを定義します。デフォルトは false です。 | false | Boolean |
| camel.dataformat.mime-multipart.enabled | mime-multipart データ形式の自動設定を有効にするかどうか。これはデフォルトで有効になっています。 | ブール値 | |
| camel.dataformat.mime-multipart.headers-inline | MIME-Multipart ヘッダーがメッセージ本文の一部であるか (true)、Camel ヘッダーとして設定されているか (false) を定義します。デフォルトは false です。 | false | Boolean |
| camel.dataformat.mime-multipart.include-headers | MIME マルチパートに MIME ヘッダーとして含まれる Camel ヘッダーを定義する正規表現。これは、headersInline が true に設定されている場合にのみ機能します。デフォルトでは、ヘッダーは含まれません。 | String | |
| camel.dataformat.mime-multipart.multipart-sub-type | MIME マルチパートのサブタイプを指定します。デフォルトは混合です。 | mixed | String |
| camel.dataformat.mime-multipart.multipart-without-attachment | 添付のないメッセージも MIME マルチパート (ボディパーツが 1 つだけ) にマーシャリングされるかどうかを定義します。デフォルトは false です。 | false | ブール値 |