357.2. オプション
Undertow コンポーネントは、以下にリストされている 5 個のオプションをサポートしています。
| 名前 | 説明 | デフォルト | タイプ |
|---|---|---|---|
| undertowHttpBinding (advanced) | カスタム HttpBinding を使用して、Camel メッセージと HttpClient との間のマッピングを制御します。 | UndertowHttpBinding | |
| sslContextParameters (security) | SSLContextParameters を使用してセキュリティーを設定する場合。 | SSLContextParameters | |
| useGlobalSslContext Parameters (security) | グローバル SSL コンテキストパラメーターの使用を有効にします。 | false | boolean |
| hostOptions (advanced) | スレッドプールなどの一般的なオプションを設定する場合。 | UndertowHostOptions | |
| resolveProperty Placeholders (advanced) | 起動時にコンポーネントがプロパティープレースホルダーを解決するかどうか。String タイプのプロパティーのみがプロパティープレースホルダーを使用できます。 | true | boolean |
Undertow エンドポイントは、URI 構文を使用して設定されます。
undertow:httpURI
パスおよびクエリーパラメーターを使用します。
357.2.1. パスパラメーター (1 個のパラメーター):
| 名前 | 説明 | デフォルト | タイプ |
|---|---|---|---|
| httpURI | 必須 使用する HTTP エンドポイントの url。 | URI |
357.2.2. クエリーパラメーター(21 パラメーター):
| 名前 | 説明 | デフォルト | タイプ |
|---|---|---|---|
| bridgeErrorHandler (consumer) | コンシューマーの Camel ルーティングエラーハンドラーへのブリッジを許可します。よって、コンシューマーが受信メッセージなどの取得を試行している間に発生した例外は、メッセージとして処理され、ルーティングエラーハンドラーによって処理されます。デフォルトでは、コンシューマーは org.apache.camel.spi.ExceptionHandler を使用して例外に対応し、WARN または ERROR レベルでログに記録され、無視されます。 | false | boolean |
| httpMethodRestrict (consumer) | GET/POST/PUT など、HttpMethod が一致する場合にのみ消費を許可するために使用されます。複数のメソッドをコンマで区切って指定できます。 | String | |
| matchOnUriPrefix (consumer) | 完全に一致するものが見つからない場合に、コンシューマーが URI 接頭辞を照合してターゲットコンシューマーを見つけようとするかどうか。 | false | Boolean |
| optionsEnabled (consumer) | このサーブレットコンシューマーに対して HTTP OPTIONS を有効にするかどうかを指定します。デフォルトでは、OPTIONS はオフになっています。 | false | boolean |
| exceptionHandler (consumer) | コンシューマーによるカスタム ExceptionHandler の使用を許可します。bridgeErrorHandler オプションが有効な場合は、このオプションは使用されないことに注意してください。デフォルトでは、コンシューマーは例外に対応し、WARN または ERROR レベルでログに記録され、無視されます。 | ExceptionHandler | |
| exchangePattern (consumer) | コンシューマーがエクスチェンジを作成する際に交換パターンを設定します。 | ExchangePattern | |
| cookieHandler (producer) | HTTP セッションを維持するようにクッキーハンドラーを設定します。 | CookieHandler | |
| keepAlive (producer) | 非アクティブのためにソケットが閉じられないようにするための設定 | true | Boolean |
| options (producer) | 追加のチャネルオプションを設定します。使用できるオプションは org.xnio.Options で定義されています。エンドポイント uri から設定するには、各オプションの前に option. を付けます (例: option.close-abort=true&option.send-buffer=8192)。 | Map | |
| reuseAddresses (producer) | ソケットの多重化を容易にするための設定 | true | Boolean |
| tcpNoDelay (producer) | TCP プロトコルのパフォーマンスを向上させるための設定 | true | Boolean |
| throwExceptionOnFailure (producer) | リモートサーバーからの応答が失敗した場合に HttpOperationFailedException を出力することを無効にするオプション。これにより、HTTP ステータスコードに関係なくすべての応答を取得できます。 | true | Boolean |
| transferException (producer) | 有効にすると、エクスチェンジがコンシューマー側で処理に失敗し、発生した例外が application/x-java-serialized-object コンテンツタイプとして応答でシリアライズされた場合に、例外がシリアライズされました。プロデューサー側では、例外がデシリアライズされ、HttpOperationFailedException ではなくそのまま出力されます。原因となった例外はシリアライズする必要があります。これは、デフォルトでオフになっています。これを有効にすると、Java が受信データをリクエストから Java にデシリアライズし、セキュリティー上のリスクが生じる可能性があることに注意してください。 | false | Boolean |
| headerFilterStrategy (advanced) | カスタムの HeaderFilterStrategy を使用して、Camel メッセージとの間でヘッダーをフィルタリングします。 | HeaderFilterStrategy | |
| synchronous (advanced) | 同期処理を厳密に使用するか、Camel が非同期処理を使用できるかどうかを設定します (サポートされている場合)。 | false | boolean |
| undertowHttpBinding (advanced) | カスタムの UndertowHttpBinding を使用して、Camel メッセージと undertow の間のマッピングを制御します。 | UndertowHttpBinding | |
| fireWebSocketChannelEvents (websocket) | true の場合、コンシューマーは、新しい WebSocket ピアが接続、切断などしたときにルートに通知を送信します。UndertowConstants.EVENT_TYPE および EventType を参照してください。 | false | boolean |
| sendTimeout (websocket) | Websocket チャネルに送信するときのミリ秒単位のタイムアウト。デフォルトのタイムアウトは 30000 (30 秒) です。 | 30000 | Integer |
| sendToAll (websocket) | すべての websocket サブスクライバーに送信します。メッセージで UndertowConstants.SEND_TO_ALL ヘッダーを使用する代わりに、エンドポイントレベルで設定するために使用できます。 | Boolean | |
| useStreaming (websocket) | true の場合、WebSocket 経由のテキストメッセージとバイナリーメッセージは、Exchange に渡される前にそれぞれ java.io.Reader と java.io.InputStream としてラップされます。それ以外の場合は、それぞれ String および byte として渡されます。 | false | boolean |
| sslContextParameters (security) | SSLContextParameters を使用してセキュリティーを設定する場合。 | SSLContextParameters |
