173.2. オプション

httpUri

必須 呼び出す HTTP エンドポイントの URL。

URI

chunked (common)

このオプションが false の場合、サーブレットは HTTP ストリーミングを無効にし、応答に content-length ヘッダーを設定します。

true

boolean

disableStreamCache (common)

サーブレットからの生の入力ストリームがキャッシュされるかどうかを決定します (Camel はストリームをメモリー内/ファイルへのオーバーフロー、ストリームキャッシュに読み込みます)。デフォルトでは、Camel はサーブレット入力ストリームをキャッシュして複数回の読み取りをサポートし、Camel がストリームからすべてのデータを取得できるようにします。ただし、ファイルやその他の永続ストアに直接ストリーミングするなど、生のストリームにアクセスする必要がある場合は、このオプションを true に設定できます。ストリームの複数回の読み取りをサポートするためにこのオプションが false の場合、DefaultHttpBinding は要求入力ストリームをストリームキャッシュにコピーし、それをメッセージ本文に入れます。サーブレットを使用してエンドポイントをブリッジ/プロキシーする場合、メッセージペイロードを複数回読み取る必要がない場合は、このオプションを有効にしてパフォーマンスを向上させることを検討してください。http/http4 プロデューサーは、デフォルトでレスポンスボディーストリームをキャッシュします。このオプションを true に設定すると、プロデューサは応答本文ストリームをキャッシュせず、応答ストリームをそのままメッセージ本文として使用します。

false

boolean

enableMultipartFilter (Common)

Jetty org.eclipse.jetty.servlets.MultiPartFilter が有効かどうか。エンドポイントをブリッジするときは、この値を false に設定して、マルチパートリクエストも確実にプロキシー/ブリッジされるようにする必要があります。

false

boolean

headerFilterStrategy (common)

カスタムの HeaderFilterStrategy を使用して、Camel メッセージとの間でヘッダーをフィルタリングします。

HeaderFilterStrategy

transferException (common)

有効にすると、エクスチェンジがコンシューマー側で処理に失敗し、発生した例外が application/x-java-serialized-object コンテンツタイプとして応答でシリアライズされた場合に、例外がシリアライズされました。プロデューサー側では、例外がデシリアライズされ、HttpOperationFailedException ではなくそのまま出力されます。原因となった例外はシリアライズする必要があります。これは、デフォルトでオフになっています。これを有効にすると、Java が受信データをリクエストから Java にデシリアライズし、セキュリティー上のリスクが生じる可能性があることに注意してください。

false

boolean

httpBinding (common)

カスタム HttpBinding を使用して、Camel メッセージと HttpClient との間のマッピングを制御します。

HttpBinding

async (consumer)

非同期モードで動作するようにコンシューマーを設定します

false

boolean

bridgeErrorHandler (consumer)

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

false

boolean

continuationTimeout (consumer)

Jetty をコンシューマー (サーバー) として使用する場合、タイムアウトをミリ秒単位で設定できます。デフォルトでは、Jetty は 30000 を使用します。= 0 の値を使用して、期限切れにならないようにすることができます。タイムアウトが発生すると、リクエストは期限切れになり、Jetty は HTTP エラー 503 をクライアントに返します。このオプションは、Asynchronous Routing Engine で Jetty を使用する場合にのみ使用されます。

30000

Long

enableCORS (consumer)

オプションが true の場合、Jetty サーバーは、すぐに使用できる CORS をサポートする CrossOriginFilter をセットアップします。

false

boolean

enableJmx (consumer)

このオプションが true の場合、Jetty JMX サポートがこのエンドポイントに対して有効になります。詳細については、Jetty JMX サポートを参照してください。

false

boolean

httpMethodRestrict (consumer)

GET/POST/PUT など、HttpMethod が一致する場合にのみ消費を許可するために使用されます。複数のメソッドをコンマで区切って指定できます。

String

matchOnUriPrefix (consumer)

完全に一致するものが見つからない場合に、コンシューマーが URI 接頭辞を照合してターゲットコンシューマーを見つけようとするかどうか。

false

boolean

responseBufferSize (consumer)

javax.servlet.ServletResponse.

Integer

sendDateHeader (consumer)

オプションが true の場合、jetty サーバーは、リクエストを送信するクライアントに日付ヘッダーを送信します。注: 他の camel-jetty エンドポイントが同じポートを共有していないことを確認してください。そうしないと、このオプションが期待どおりに機能しない可能性があります。

false

boolean

sendServerVersion (consumer)

オプションが true の場合、jetty はリクエストを送信するクライアントに、jetty のバージョン情報を含むサーバーヘッダーを送信します。注: 他の camel-jetty エンドポイントが同じポートを共有していないことを確認してください。そうしないと、このオプションが期待どおりに機能しない可能性があります。

true

boolean

sessionSupport (consumer)

Jetty のサーバー側でセッションマネージャーを有効にするかどうかを指定します。

false

boolean

useContinuation (consumer)

Jetty サーバーに Jetty 継続を使用するかどうか。

Boolean

eagerCheckContentAvailable (consumer)

content-length ヘッダーが 0 または存在しない場合に、HTTP リクエストにコンテンツがあるかどうかを先行チェックするかどうか。これは、HTTP クライアントがストリーミングデータを送信しない場合に有効にすることができます。

false

boolean

exceptionHandler (consumer)

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

ExceptionHandler

exchangePattern (consumer)

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

ExchangePattern

filterInitParameters (consumer)

フィルター初期パラメーターの設定。これらのパラメーターは、jetty サーバーを起動する前にフィルターリストに適用されます。

Map

filtersRef (consumer)

リストに入れられ、レジストリーで見つけることができるカスタムフィルターを使用できます。複数の値はコンマで区切ることができます。

String

handlers (consumer)

レジストリーで検索する Handler インスタンスのコンマ区切りのセットを指定します。これらのハンドラーは、Jetty サーブレットコンテキストに追加されます (たとえば、セキュリティーを追加するため)。重要: 同じポート番号を使用して、異なる Jetty エンドポイントで異なるハンドラーを使用することはできません。ハンドラーはポート番号に関連付けられています。別のハンドラーが必要な場合は、別のポート番号を使用してください。

String

httpBindingRef (consumer)

非推奨 リモートサーバーからの応答が失敗した場合に HttpOperationFailedException を出力することを無効にするオプション。これにより、HTTP ステータスコードに関係なくすべての応答を取得できます。

String

multipartFilter (consumer)

カスタムマルチパートフィルターの使用を許可します。注記: multipartFilterRef を設定すると、enableMultipartFilter の値が強制的に true になります。

Filter

multipartFilterRef (consumer)

非推奨 カスタムマルチパートフィルターの使用を許可します。注記: multipartFilterRef を設定すると、enableMultipartFilter の値が強制的に true になります。

String

optionsEnabled (consumer)

このサーブレットコンシューマーに対して HTTP OPTIONS を有効にするかどうかを指定します。デフォルトでは、OPTIONS はオフになっています。

false

boolean

traceEnabled (consumer)

このサーブレットコンシューマーに対して HTTP TRACE を有効にするかどうかを指定します。デフォルトでは、TRACE はオフになっています。

false

boolean

bridgeEndpoint (producer)

オプションが true の場合、HttpProducer は Exchange.HTTP_URI ヘッダーを無視し、エンドポイントの URI を要求に使用します。オプション throwExceptionOnFailure を false に設定して、HttpProducer がすべての障害応答を送り返すようにすることもできます。

false

boolean

connectionClose (producer)

Connection Close ヘッダーを HTTP 要求に追加する必要があるかどうかを指定します。デフォルトでは、connectionClose は false です。

false

boolean

cookieHandler (producer)

HTTP セッションを維持するようにクッキーハンドラーを設定します。

CookieHandler

copyHeaders (producer)

このオプションが true の場合、IN 交換ヘッダーは、コピー戦略に従って OUT 交換ヘッダーにコピーされます。これを false に設定すると、HTTP 応答からのヘッダーのみを含めることができます (IN ヘッダーは伝播されません)。

true

boolean

httpClientMaxThreads (producer)

HttpClient スレッドプールの最大スレッド数の値を設定します。この設定は、コンポーネントレベルで設定されたすべての設定を上書きします。最小サイズと最大サイズの両方を設定する必要があることに注意してください。設定されていない場合、Jettys スレッドプールで使用される最大 254 スレッドにデフォルト設定されます。

254

Integer

httpClientMinThreads (producer)

HttpClient スレッドプールのスレッドの最小数の値を設定します。この設定は、コンポーネントレベルで設定されたすべての設定を上書きします。最小サイズと最大サイズの両方を設定する必要があることに注意してください。設定されていない場合、Jettys スレッドプールで使用される最小 8 スレッドにデフォルト設定されます。

8

Integer

httpMethod (producer)

使用する HTTP メソッドを設定します。設定されている場合、HttpMethod ヘッダーはこのオプションをオーバーライドできません。

HttpMethods

ignoreResponseBody (producer)

このオプションが true の場合、http プロデューサーは応答本文を読み取らず、入力ストリームをキャッシュしません。

false

boolean

preserveHostHeader (producer)

オプションが true の場合、HttpProducer は Host ヘッダーを現在の Exchange Host ヘッダーに含まれる値に設定します。これは、ダウンストリームサーバーが受信した Host ヘッダーにアップストリームクライアントが呼び出した URL を反映させたいリバースプロキシーアプリケーションで役立ちます。Host ヘッダーを使用するアプリケーションが、プロキシーされたサービスの正確な URL を生成できるようにします。

false

boolean

throwExceptionOnFailure (producer)

リモートサーバーからの応答が失敗した場合に HttpOperationFailedException を出力することを無効にするオプション。これにより、HTTP ステータスコードに関係なくすべての応答を取得できます。

true

boolean

httpClient (producer)

このエンドポイントによって作成されたすべてのプロデューサーに使用する共有 HttpClient を設定します。デフォルトでは、各プロデューサーは新しい http クライアントを使用し、共有しません。重要: クライアントが使用されなくなった場合は、クライアントを停止するなど、共有クライアントのライフサイクルを必ず処理してください。Camel はクライアントで start メソッドを呼び出して、このエンドポイントがプロデューサーを作成するときに確実に開始されるようにします。このオプションは、特別な状況でのみ使用してください。

HttpClient

httpClientParameters (producer)

Jetty の HttpClient の設定。たとえば、httpClient.idleTimeout=30000 を設定すると、アイドルタイムアウトが 30 秒に設定されます。また、httpClient.timeout=30000 は、リクエスト/レスポンスコールを長時間実行している場合にタイムアウトを早くしたい場合に備えて、リクエストタイムアウトを 30 秒に設定します。

Map

jettyBinding (producer)

プロデューサーへの応答の書き込み方法をカスタマイズするために使用されるカスタム JettyHttpBinding を使用します。

JettyHttpBinding

jettyBindingRef (producer)

非推奨 プロデューサー向けの応答の書き込み方法をカスタマイズするために使用されるカスタム JettyHttpBinding を使用すること。

String

okStatusCodeRange (producer)

正常な応答と見なされるステータスコード。値は含まれます。複数の範囲をコンマで区切って定義できます (例: 200-204,209,301-304)。各範囲は、ダッシュを含む 1 つの数字または from-to である必要があります。

200-299

String

urlRewrite (producer)

非推奨 カスタム org.apache.camel.component.http.UrlRewrite を参照して、エンドポイントをブリッジ/プロキシーするときに URL を書き換えることができます。詳細は、http://camel.apache.org/urlrewrite.html を参照してください。

UrlRewrite

mapHttpMessageBody (advanced)

このオプションが true の場合、交換の IN exchange ボディは HTTP ボディにマップされます。これを false に設定すると、HTTP マッピングが回避されます。

true

boolean

mapHttpMessageFormUrl EncodedBody (advanced)

このオプションが true の場合、交換の IN exchange Form Encoded ボディは HTTP にマップされます。これを false に設定すると、HTTP Form Encoded ボディマッピングが回避されます。

true

boolean

mapHttpMessageHeaders (advanced)

このオプションが true の場合、交換の IN exchange ヘッダーは HTTP ヘッダーにマップされます。これを false に設定すると、HTTP ヘッダーのマッピングが回避されます。

true

boolean

synchronous (advanced)

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

false

boolean

proxyAuthScheme (proxy)

使用するプロキシー認証スキーム

String

proxyHost (proxy)

使用するプロキシーホスト名

String

proxyPort (proxy)

使用するプロキシーポート

int

authHost (security)

NTML で使用する認証ホスト

String

sslContextParameters (security)

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

SSLContextParameters