113.4. コンポーネントオプション
プラットフォーム HTTP コンポーネントは、以下に示す 5 つのオプションをサポートしています。
| 名前 | 説明 | デフォルト | タイプ |
|---|---|---|---|
| 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) リンクのコピーリンクがクリップボードにコピーされました!
| 名前 | 説明 | デフォルト | タイプ |
|---|---|---|---|
| path (consumer) | 必須 このエンドポイントが HTTP 要求を提供するパス。プロキシーの場合は 'proxy' を使用します。 | String |
113.4.1.2. クエリーパラメーター (21 パラメーター) リンクのコピーリンクがクリップボードにコピーされました!
| 名前 | 説明 | デフォルト | タイプ |
|---|---|---|---|
| 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 を送信することを防ぐかどうかを設定します。列挙値:
| 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 がエクスチェンジを作成する際に交換パターンを設定します。 列挙値:
| ExchangePattern | |
| fileNameExtWhitelist (consumer (advanced)) | ファイル拡張子のコンマまたは空白で区切られたリスト。これらの拡張子を持つアップロードはローカルに保存されます。Null 値またはアスタリスク () は、すべてのファイルを許可します。 | String | |
| headerFilterStrategy (advanced) | カスタム HeaderFilterStrategy を使用して、Camel メッセージとの間でヘッダーをフィルタリングします。 | HeaderFilterStrategy | |
| platformHttpEngine (advanced) | このエンドポイントのリクエストを処理するための HTTP サーバーエンジンの実装。 | PlatformHttpEngine |