315.2. URI オプション
Spark Rest コンポーネントは、以下に示す 12 個のオプションをサポートしています。
| 名前 | 説明 | デフォルト | タイプ |
|---|---|---|---|
| port (consumer) | ポート番号デフォルトでは 4567 を使用します | 4567 | int |
| ipAddress (consumer) | Spark がリッスンする IP アドレスを設定します。呼び出されない場合、デフォルトのアドレスは 0.0.0.0 です。 | 0.0.0.0 | String |
| minThreads (advanced) | Spark スレッドプール内のスレッドの最小数 (グローバルに共有) | int | |
| maxThreads (advanced) | Spark スレッドプール内のスレッドの最大数 (グローバルに共有) | int | |
| timeOutMillis (advanced) | 長時間アイドル状態だったスレッドがスレッドプールから終了するスレッドアイドルタイムアウト (ミリ秒)。 | int | |
| keystoreFile (security) | キーストアファイルを使用するように接続を安全に設定します。 | String | |
| keystorePassword (security) | キーストアのパスワードを使用するように接続を安全に設定します。 | String | |
| truststoreFile (security) | トラストストアファイルを使用するように接続を安全に設定します。 | String | |
| truststorePassword (security) | トラストストアのパスワードを使用するように接続を安全に設定します。 | String | |
| sparkConfiguration (advanced) | 共有 SparkConfiguration を使用する場合。 | SparkConfiguration | |
| sparkBinding (advanced) | カスタム SparkBinding を使用して Camel メッセージとの間でマッピングします。 | SparkBinding | |
| resolveProperty Placeholders (advanced) | 起動時にコンポーネントがプロパティープレースホルダーを解決するかどうか。String タイプのプロパティーのみがプロパティープレースホルダーを使用できます。 | true | boolean |
Spark Rest エンドポイントは、URI 構文を使用して設定されます。
spark-rest:verb:path
パスおよびクエリーパラメーターを使用します。
315.2.1. パスパラメーター (2 個のパラメーター):
| 名前 | 説明 | デフォルト | タイプ |
|---|---|---|---|
| verb | 必須 get、post、put、patch、delete、head、trace、connect、または options。 | String | |
| path | 必須 Spark 構文をサポートするコンテンツパス。 | String |
315.2.2. クエリーパラメーター (11 パラメーター)
| 名前 | 説明 | デフォルト | タイプ |
|---|---|---|---|
| accept (consumer) | text/xml または application/json などのタイプを受け入れます。デフォルトでは、すべての種類のタイプを受け入れます。 | String | |
| bridgeErrorHandler (consumer) | consumer の Camel ルーティングエラーハンドラーへのブリッジを許可します。よって、consumer が受信メッセージなどの取得を試行している間に発生した例外は、メッセージとして処理され、ルーティングエラーハンドラーによって処理されます。デフォルトでは、consumer は org.apache.camel.spi.ExceptionHandler を使用して例外に対応し、WARN または ERROR レベルでログに記録され、無視されます。 | false | boolean |
| disableStreamCache (consumer) | Spark HttpRequest#getContent() からの raw 入力ストリームがキャッシュされているかどうかを決定します (Camel はストリームを軽量メモリーベースのストリームキャッシュに読み込みます)。デフォルトでは、Camel はサーブレット入力ストリームをキャッシュして複数回の読み取りをサポートし、Camel がストリームからすべてのデータを取得できるようにします。ただし、ファイルやその他の永続ストアに直接ストリーミングするなど、生のストリームにアクセスする必要がある場合は、このオプションを true に設定できます。このオプションを有効にすると、そのままでは Netty ストリームを複数回読み取ることができず、Spark の raw ストリームのリーダーインデックスを手動でリセットする必要があることに注意してください。 | false | boolean |
| mapHeaders (consumer) | このオプションを有効にすると、Spark から Camel Message へのバインド中にヘッダーもマップされます (たとえば、ヘッダーとして Camel Message にも追加されます)。このオプションをオフにして、これを無効にすることができます。ヘッダーには、Spark HTTP リクエストインスタンスを返すメソッド getRequest() を使用して、org.apache.camel.component.sparkrest.SparkMessage メッセージから引き続きアクセスできます。 | true | boolean |
| transferException (consumer) | 有効にすると、エクスチェンジがコンシューマー側で処理に失敗し、発生した例外が application/x-java-serialized-object コンテンツタイプとして応答でシリアライズされた場合に、例外がシリアライズされました。これは、デフォルトでオフになっています。これを有効にすると、Java が受信データをリクエストから Java にデシリアライズし、セキュリティー上のリスクが生じる可能性があることに注意してください。 | false | boolean |
| urlDecodeHeaders (consumer) | このオプションを有効にすると、Spark から Camel Message へのバインド中にヘッダー値が URL デコードされます (たとえば、%20 はスペース文字になります)。 | false | boolean |
| exceptionHandler (consumer) | コンシューマーによるカスタム ExceptionHandler の使用を許可します。bridgeErrorHandler オプションが有効な場合は、このオプションは使用されないことに注意してください。デフォルトでは、consumer は例外に対応し、WARN または ERROR レベルでログに記録され、無視されます。 | ExceptionHandler | |
| exchangePattern (consumer) | コンシューマーがエクスチェンジを作成する際に交換パターンを設定します。 | ExchangePattern | |
| matchOnUriPrefix (advanced) | 完全に一致するものが見つからない場合に、コンシューマーが URI 接頭辞を照合してターゲットコンシューマーを見つけようとするかどうか。 | false | boolean |
| sparkBinding (advanced) | カスタム SparkBinding を使用して Camel メッセージとの間でマッピングします。 | SparkBinding | |
| synchronous (advanced) | 同期処理を厳密に使用するか、Camel が非同期処理を使用できるかどうかを設定します (サポートされている場合)。 | false | boolean |
