113.4. コンポーネントオプション


プラットフォーム HTTP コンポーネントは、以下に示す 5 つのオプションをサポートしています。

Expand
名前説明デフォルトタイプ

bridgeErrorHandler (consumer)

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

false

boolean

handleWriteResponseError (consumer)

Camel がメッセージの処理を完了し、HTTP サーバーが応答を書き込んでいる場合。このオプションは、Camel が応答の書き込み中に障害をキャッチし、これを Exchange に保存するかどうかを制御します。これにより、onCompletion/UnitOfWork は Exchange を失敗したとみなし、HTTP サーバーから発生した例外にアクセスできるようになります。

false

boolean

autowiredEnabled (advanced)

自動ワイヤリングが有効になっているかどうか。自動ワイヤリングオプション (自動ワイヤリングとマークする必要あり) で使用されます。レジストリー内を、タイプが一致するシングルインスタンスがあるか検索し、それをコンポーネント上で設定します。これは、JDBC データソース、JMS 接続ファクトリー、AWS クライアントなどの自動設定に使用できます。

true

boolean

engine (advanced)

リクエストを処理するための HTTP サーバーエンジンの実装。

 

PlatformHttpEngine

headerFilterStrategy (filter)

カスタムの org.apache.camel.spi.HeaderFilterStrategy を使用して、Camel メッセージとの間でヘッダーをフィルターします。

 

HeaderFilterStrategy

113.4.1. エンドポイントオプション

プラットフォーム HTTP エンドポイントは、URI 構文を使用して設定されます。

platform-http:path

パスおよびクエリーパラメーターを使用します。

113.4.1.1. Path パラメーター (1 parameters)

Expand
名前説明デフォルトタイプ

path (consumer)

必須 このエンドポイントが HTTP 要求を提供するパス。プロキシーの場合は 'proxy' を使用します。

 

String

113.4.1.2. クエリーパラメーター (21 パラメーター)

Expand
名前説明デフォルトタイプ

consumes (consumer)

このエンドポイントが入力として受け入れるコンテンツタイプ (application/xml や application/json など)。null または / 制限なしを意味します。

 

String

cookieDomain (consumer)

Cookie を受信できるサーバーを設定します。

 

String

cookieHttpOnly (consumer)

作成された Cookie にクライアント側のスクリプトがアクセスできないようにするかどうかを設定します。

false

boolean

cookieMaxAge (consumer)

Cookie の最大存続期間を秒単位で設定します。

 

Long

cookiePath (consumer)

Cookie を送信するために、要求された URL に存在する必要がある URL パスを設定します。

/

String

cookieSameSite (consumer)

ブラウザーがクロスサイトリクエストと共に Cookie を送信することを防ぐかどうかを設定します。列挙値:

  • STRICT
  • LAX
  • NONE

Lax

CookieSameSite

cookieSecure (consumer)

Cookie をサーバーに送信する場合に、HTTPS 経由の暗号化されたリクエストのみ使用を許可するかどうか設定します。

false

boolean

handleWriteResponseError (consumer)

Camel がメッセージの処理を完了し、HTTP サーバーが応答を書き込んでいる場合。このオプションは、Camel が応答の書き込み中に障害をキャッチし、これを Exchange に保存するかどうかを制御します。これにより、onCompletion/UnitOfWork は Exchange を失敗したとみなし、HTTP サーバーから発生した例外にアクセスできるようになります。

false

boolean

httpMethodRestrict (consumer)

GET,POST など、提供する HTTP メソッドのコンマ区切りリスト。メソッドが指定されていない場合、すべてのメソッドが提供されます。

 

String

matchOnUriPrefix (consumer)

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

false

boolean

muteException (consumer)

有効にすると、エクスチェンジが consumer 側で処理に失敗した場合、レスポンスの本文には例外のスタックトレースが含まれません。

true

boolean

produces (consumer)

このエンドポイントが生成するコンテンツタイプ (application/xml や application/json など)。

 

String

returnHttpRequestHeaders (consumer)

このエンドポイントによって生成される HTTP 応答に HTTP 要求ヘッダー (Accept、User-Agent など) を含めるかどうか。

false

boolean

useCookieHandler (consumer)

Cookie の追加、有効期限、取得を可能にする Cookie Handler を有効にするかどうか (現在は camel-platform-http-vertx でのみサポートされています)。

false

boolean

useStreaming (consumer)

大規模な要求と応答にストリーミングを使用するかどうか (現在は camel-platform-http-vertx でのみサポートされています)。

false

boolean

bridgeErrorHandler (consumer (advanced))

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

false

boolean

exceptionHandler (consumer (advanced))

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

 

ExceptionHandler

exchangePattern (consumer (advanced))

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

列挙値:

  • InOnly
  • InOut
  • InOptionalOut
 

ExchangePattern

fileNameExtWhitelist (consumer (advanced))

ファイル拡張子のコンマまたは空白で区切られたリスト。これらの拡張子を持つアップロードはローカルに保存されます。Null 値またはアスタリスク () は、すべてのファイルを許可します。

 

String

headerFilterStrategy (advanced)

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

 

HeaderFilterStrategy

platformHttpEngine (advanced)

このエンドポイントのリクエストを処理するための HTTP サーバーエンジンの実装。

 

PlatformHttpEngine

Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

Red Hat ドキュメントについて

Legal Notice

Theme

© 2026 Red Hat
トップに戻る