207.3.2. クエリーパラメーター（62 パラメーター）:

bridgeErrorHandler (consumer)

コンシューマーの Camel ルーティングエラーハンドラーへのブリッジを許可します。よって、コンシューマーが受信メッセージなどの取得を試行している間に発生した例外は、メッセージとして処理され、ルーティングエラーハンドラーによって処理されます。デフォルトでは、コンシューマーは org.apache.camel.spi.ExceptionHandler を使用して例外に対応し、WARN または ERROR レベルでログに記録され、無視されます。

false

boolean

closeFolder (consumer)

ポーリング後にコンシューマーがフォルダーを終了するかどうか。このオプションを false に設定して disconnect=false を設定し、その後、コンシューマーはポーリング間でフォルダーを開いたままにします。

true

boolean

copyTo (consumer)

メールメッセージの処理後、指定した名前のメールフォルダーにコピーできます。この設定値を上書きするには、キー copyTo を持つヘッダーを使用して、実行時に設定されたフォルダー名にメッセージをコピーできます。

文字列

Delete （コンシューマー）

メッセージの処理後にメッセージを削除します。これは、メールメッセージに DELETED フラグを設定して行います。false の場合、SEEN フラグが代わりに設定されます。Camel 2.10 以降では、キー delete でヘッダーを設定し、メールを削除するかどうかを決定することにより、この設定オプションを上書きできます。

false

boolean

disconnect (consumer)

ポーリング後にコンシューマーが切断されるかどうか。これを有効にすると、Camel が各ポーリングで強制的に接続されます。

false

boolean

handleFailedMessage (consumer)

メールコンシューマーが指定のメールメッセージを取得できない場合、このオプションではコンシューマーのエラーハンドラーによって原因となった例外を処理できます。コンシューマーでブリッジエラーハンドラーを有効にすると、Camel ルーティングエラーハンドラーが代わりに例外を処理できます。デフォルトの動作はコンシューマーによって例外がスローされ、バッチからのメールは Camel によってルーティングできません。

false

boolean

maxMessagesPerPoll (consumer)

ポーリングごとに収集するメッセージの最大数を指定します。デフォルトでは、最大値は設定されません。サーバーの起動時に数千ものファイルをダウンロードしないように 1000 などの制限を設定できます。このオプションを無効にするには、0 または negative の値を設定します。

int

mimeDecodeHeaders (consumer)

このオプションを使用すると、メールヘッダーの透過的な MIME デコードおよびアンロックが可能になります。

false

boolean

peek （コンシューマー）

メールメッセージを処理する前に、javax.mail.Message を peeked とマークします。これは IMAPMessage メッセージタイプのみに適用されます。peek を使用すると、メールはメールサーバーで SEEN としてマークされません。これにより、Camel にエラー処理がある場合は、メールメッセージをロールバックできます。

true

boolean

sendEmptyMessageWhenIdle (consumer)

ポーリングコンシューマーがファイルをポーリングしなかった場合、このオプションを有効にして、代わりに空のメッセージ (ボディーなし) を送信できます。

false

boolean

skipFailedMessage (consumer)

メールコンシューマーが指定のメールメッセージを取得できない場合、このオプションではメッセージを省略し、次のメールメッセージの取得を許可します。デフォルトの動作はコンシューマーによって例外がスローされ、バッチからのメールは Camel によってルーティングできません。

false

boolean

Unseen (consumer)

参照されていないメールによってのみ制限するかどうか。

true

boolean

exceptionHandler (consumer)

コンシューマーによるカスタム ExceptionHandler の使用を許可します。bridgeErrorHandler オプションが有効な場合は、このオプションは使用されていないことに注意してください。デフォルトでは、コンシューマーは例外に対応し、WARN または ERROR レベルでログに記録され、無視されます。

ExceptionHandler

exchangePattern (consumer)

コンシューマーがエクスチェンジを作成する際に交換パターンを設定します。

ExchangePattern

fetchSize (consumer)

ポーリング中に消費するメッセージの最大数を設定します。メールボックスのフォルダーに多くのメッセージが含まれる場合、これを使用するとメールサーバーのオーバーロードを防ぐことができます。デフォルト値の -1 はフェッチサイズがなく、すべてのメッセージが消費されます。値を 0 に設定することは特別なもので、Camel はメッセージを全く消費しません。

-1

int

folderName (consumer)

ポーリングするフォルダー。

INBOX

文字列

mailUidGenerator (consumer)

カスタムロジックを使用してメールメッセージの UUID を生成できるようにするプラグ可能な MailUidGenerator。

MailUidGenerator

mapMailMessage (consumer)

Camel が受信したメールメッセージを Camel の本文/ヘッダーにマッピングするかどうかを指定します。true に設定すると、メールメッセージのボディーが Camel IN メッセージのボディーにマッピングされ、メールヘッダーは IN ヘッダーにマッピングされます。このオプションを false に設定すると、IN メッセージには raw javax.mail.Message が含まれます。exchange.getIn（）.getBody(javax.mail.Message.class)を呼び出すことで、この未加工メッセージを取得できます。

true

boolean

pollStrategy (consumer)

プラグ可能な org.apache.camel.PollingConsumerPollingStrategy を使用すると、エクスチェンジが作成され、Camel でルーティングされる前に、通常はポーリング操作中に発生するエラー処理を制御するカスタム実装が提供できます。

PollingConsumerPoll Strategy

postProcessAction (consumer)

通常の処理が終了したら、メールボックスで後続処理を行う MailBoxPostProcessAction を参照します。

MailBoxPostProcess Action

bcc （プロデューサー）

BCC メールアドレスを設定します。複数のメールアドレスはコンマで区切ります。

文字列

cc (producer)

CC のメールアドレスを設定します。複数のメールアドレスはコンマで区切ります。

文字列

from (producer)

from メールアドレス

camel@localhost

文字列

replyTo (producer)

Reply-To 受信者（応答メールの受信側）。複数のメールアドレスはコンマで区切ります。

文字列

Subject (producer)

送信されるメッセージの件名。注記： ヘッダーにサブジェクトを設定することは、このオプションよりも優先されます。

文字列

to （プロデューサー）

To email address を設定します。複数のメールアドレスはコンマで区切ります。

文字列

javaMailSender (producer)

メールの送信にカスタムの org.apache.camel.component.mail.JavaMailSender を使用します。

JavaMailSender

additionalJavaMail Properties (advanced)

その他のすべてのオプションに基づいて設定されるデフォルトのプロパティーを追記/無効化する追加の java メールプロパティーを設定します。これは、特別なオプションを追加する必要があるものの、他のオプションをそのまま維持する必要がある場合に便利です。

プロパティー

alternativeBodyHeader (advanced)

別のメールボディーが含まれる IN メッセージヘッダーへのキーを指定します。たとえば、text/html 形式でメールを送信し、HTML 以外の電子メールクライアントの代替メール本文を提供する場合は、このキーを持つ別のメールボディをヘッダーとして設定します。

CamelMailAlternativeBody

文字列

attachmentsContentTransfer EncodingResolver (advanced)

カスタムの 接続先ContentTransferEncodingResolver を使用して添付に使用する content-type-encoding を解決します。

disconnectContent TransferEncoding Resolver

バインディング （詳細）

Camel メッセージからメールメッセージとの間で変換するために使用されるバインディングを設定します。

MailBinding

connectionTimeout (advanced)

接続のタイムアウト（ミリ秒単位）。

30000

int

contentType (advanced)

メールメッセージのコンテンツタイプ。HTML メールには text/html を使用します。

text/plain

文字列

contentTypeResolver (advanced)

ファイル添付の Content-Type を決定するリゾルバー。

ContentTypeResolver

debugMode (advanced)

基礎となるメールフレームワークでデバッグモードを有効にします。SUN Mail フレームワークは、デフォルトでデバッグメッセージを System.out にロギングします。

false

boolean

headerFilterStrategy (advanced)

カスタムの org.apache.camel.spi.HeaderFilterStrategy を使用してヘッダーをフィルターします。

HeaderFilterStrategy

ignoreUnsupportedCharset (advanced)

メールの送信時に Camel がローカル JVM でサポートされない文字セットを無視するオプション。charset がサポートされない場合は、charset=XXX（XXX はサポートされない文字セットを表します）が、コンテンツタイプから削除され、代わりにプラットフォームのデフォルトに依存します。

false

boolean

ignoreUriScheme (advanced)

メールの送信時に Camel がローカル JVM でサポートされない文字セットを無視するオプション。charset がサポートされない場合は、charset=XXX（XXX はサポートされない文字セットを表します）が、コンテンツタイプから削除され、代わりにプラットフォームのデフォルトに依存します。

false

boolean

セッション （詳細）

camel がすべてのメール対話に使用するメールセッションを指定します。メールセッションが他のリソースによって作成および管理されるシナリオで役に立ちます。これが指定されていない場合、Camel はメールセッションを自動的に作成します。

Session

同期 （詳細）

同期処理を厳密に使用するか、Camel が非同期処理を使用できるようにするかを設定します（サポートされている場合）。

false

boolean

useInlineAttachments (advanced)

配置のインラインまたは添付を使用するかどうか。

false

boolean

idempotentRepository (filter)

同じメールボックスから消費できるプラグ可能なリポジトリー org.apache.camel.spi.IdempotentRepository。デフォルトでは、使用中のリポジトリーはありません。

String>

idempotentRepositoryRemove OnCommit (filter)

べき等リポジトリーを使用する場合、メールメッセージが正常に処理され、コミットされると、メッセージ ID がべき等リポジトリー（デフォルト）から削除されるか、リポジトリーに保持される必要があります。デフォルトでは、メッセージ ID が一意であることを前提としており、メールメッセージが認識/移動または削除され、再度消費されないようにするため、リポジトリーに値が保存されていません。そのため、メッセージ ID がべき等リポジトリーに保存されていると、値がほとんどありません。ただし、このオプションを使用すると、何らかの理由でメッセージ ID を保存できます。

true

boolean

searchTerm (filter)

javax.mail.search.SearchTerm を参照します。

SearchTerm

backoffErrorThreshold (scheduler)

backoffMultipler が開始する前に発生する必要がある後続のエラーポーリング (エラーによって失敗した) の数。

int

backoffIdleThreshold (scheduler)

backoffMultipler が開始する前に発生する必要がある後続のアイドルポーリングの数。

int

backoffMultiplier (scheduler)

後続のアイドル状態/エラーが連続して発生した場合に、スケジュールされたポーリングコンシューマーのバックオフを許可します。乗数は、実際に次の試行が行われる前にスキップされるポーリングの数です。このオプションが使用されている場合は、backoffIdleThreshold や backoffErrorThreshold も設定する必要があります。

int

遅延 （スケジューラー）

次のポーリングまでの時間 (ミリ秒単位)。

60000

Long

greedy (scheduler)

greedy が有効で、以前の実行が 1 つ以上のメッセージをポーリングした場合、ScheduledPollConsumer は即座に再度実行されます。

false

boolean

initialDelay (scheduler)

最初のポーリングが開始されるまでの時間 (ミリ秒単位)。また、60 秒（60 秒）、5m30s（5 分と 30 秒）、および 1h（1 時間）などの単位を使用して時間の値を指定することもできます。

1000

Long

runLoggingLevel (scheduler)

コンシューマーはポーリング時に開始/完了のログ行を記録します。このオプションを使用すると、ログレベルを設定できます。

TRACE

LoggingLevel

scheduledExecutorService (scheduler)

コンシューマーに使用するカスタム/共有スレッドプールを設定できます。デフォルトでは、各コンシューマーに独自の単一スレッドのスレッドプールがあります。

ScheduledExecutor Service

scheduler (scheduler)

camel-spring または camel-quartz2 コンポーネントからの cron スケジューラーを使用するには、以下を実行します。

none

ScheduledPollConsumer Scheduler

schedulerProperties (scheduler)

カスタムスケジューラーまたは Quartz2、Spring ベースのスケジューラーを使用する場合に追加のプロパティーを設定します。

マップ

startScheduler (scheduler)

スケジューラーを自動起動するかどうか。

true

boolean

timeUnit (scheduler)

initialDelay および delay オプションの時間単位。

ミリ秒

TimeUnit

useFixedDelay (scheduler)

固定遅延または固定レートを使用するかどうかを制御します。詳細は、JDK の ScheduledExecutorService を参照してください。

true

boolean

sortTerm (sort)

メッセージのソート順序。IMAP ではネイティブでしかサポートされません。POP3 を使用する場合や、IMAP サーバーに SORT 機能がない場合、ある程度エミュレートされます。

文字列

dummyTrustManager (security)

すべての証明書を信頼するためにダミーのセキュリティー設定を使用します。開発モードにのみ使用し、実稼働モードにのみ使用してください。

false

boolean

パスワード （セキュリティー）

ログインのパスワード

文字列

sslContextParameters (security)

SSLContextParameters を使用してセキュリティーを設定します。

SSLContextParameters

ユーザー名 （セキュリティー）

ログインのユーザー名

文字列