第348章 XQuery コンポーネント
Camel バージョン 1.0 以降で利用可能
Camel は XQuery をサポートして、式または述語を DSL または Xml 設定 で使用できるようにします。たとえば、XQuery を使用して メッセージフィルター の述語を作成したり、受信者リストの式として使用したりできます。
348.1. オプション
XQuery コンポーネントは、以下に示す 4 個のオプションをサポートしています。
名前 | 説明 | デフォルト | タイプ |
---|---|---|---|
moduleURIResolver (advanced) | カスタム ModuleURIResolver を使用します | ModuleURIResolver | |
configuration (advanced) | カスタム Saxon 設定を使用します | 設定 | |
configurationProperties (advanced) | カスタムの Saxon 設定プロパティーを設定します | Map | |
resolveProperty Placeholders (advanced) | 起動時にコンポーネントがプロパティープレースホルダーを解決するかどうか。String タイプのプロパティーのみがプロパティープレースホルダーを使用できます。 | true | boolean |
XQuery エンドポイントは、URI 構文を使用して設定されます。
xquery:resourceUri
パスおよびクエリーパラメーターを使用します。
348.1.1. パスパラメーター (1 個のパラメーター):
名前 | 説明 | デフォルト | タイプ |
---|---|---|---|
resourceUri | 必須 クラスパスまたはファイルシステムからロードするテンプレートの名前。 | String |
348.1.2. Query Parameters (31 parameters):
名前 | 説明 | デフォルト | タイプ |
---|---|---|---|
allowStAX (common) | StAX モードの使用を許可するかどうか。 | false | boolean |
headerName (common) | メッセージ本文の代わりに Camel メッセージヘッダーを入力ソースとして使用します。 | String | |
namespacePrefixes (common) | 名前空間マッピングのセットに使用する名前空間接頭辞を制御できます。 | Map | |
resultsFormat (common) | どの出力結果を使用するか。 | DOM | ResultFormat |
resultType (common) | クラスとして定義されたどの出力結果を使用するか。 | Class<?> | |
stripsAllWhiteSpace (common) | すべての空白を削除するかどうか。 | true | boolean |
bridgeErrorHandler (consumer) | コンシューマーの Camel ルーティングエラーハンドラーへのブリッジを許可します。よって、コンシューマーが受信メッセージなどの取得を試行している間に発生した例外は、メッセージとして処理され、ルーティングエラーハンドラーによって処理されます。デフォルトでは、コンシューマーは org.apache.camel.spi.ExceptionHandler を使用して例外に対応し、WARN または ERROR レベルでログに記録され、無視されます。 | false | boolean |
sendEmptyMessageWhenIdle (consumer) | ポーリングコンシューマーがファイルをポーリングしなかった場合、このオプションを有効にして、代わりに空のメッセージ (ボディーなし) を送信できます。 | false | boolean |
exceptionHandler (consumer) | コンシューマーによるカスタム ExceptionHandler の使用を許可します。bridgeErrorHandler オプションが有効な場合は、このオプションは使用されないことに注意してください。デフォルトでは、コンシューマーは例外に対応し、WARN または ERROR レベルでログに記録され、無視されます。 | ExceptionHandler | |
exchangePattern (consumer) | コンシューマーがエクスチェンジを作成する際に交換パターンを設定します。 | ExchangePattern | |
pollStrategy (consumer) | プラグ可能な org.apache.camel.PollingConsumerPollingStrategy を使用すると、エクスチェンジが作成され、Camel でルーティングされる前に、通常はポーリング操作中に発生するエラー処理を制御するカスタム実装が提供できます。 | PollingConsumerPoll Strategy | |
configuration (advanced) | カスタム Saxon 設定を使用します | 設定 | |
configurationProperties (advanced) | カスタムの Saxon 設定プロパティーを設定します | Map | |
moduleURIResolver (advanced) | カスタム ModuleURIResolver を使用します | ModuleURIResolver | |
parameters (advanced) | 追加のパラメーター | Map | |
properties (advanced) | シリアル化パラメーターを設定するためのプロパティー。 | Properties | |
staticQueryContext (advanced) | カスタム Saxon StaticQueryContext を使用する場合。 | StaticQueryContext | |
synchronous (advanced) | 同期処理を厳密に使用するか、Camel が非同期処理を使用できるかどうかを設定します (サポートされている場合)。 | false | boolean |
backoffErrorThreshold (scheduler) | backoffMultipler が開始する前に発生する必要がある後続のエラーポーリング (エラーによって失敗した) の数。 | int | |
backoffIdleThreshold (scheduler) | backoffMultipler が開始する前に発生する必要がある後続のアイドルポーリングの数。 | int | |
backoffMultiplier (scheduler) | 後続のアイドル状態/エラーが連続して発生した場合に、スケジュールされたポーリングコンシューマーのバックオフを許可します。乗数は、実際に次の試行が行われる前にスキップされるポーリングの数です。このオプションが使用されている場合は、backoffIdleThreshold や backoffErrorThreshold も設定する必要があります。 | int | |
delay (scheduler) | 次のポーリングまでの時間 (ミリ秒単位)。60s (60 秒)、5m30s (5 分 30 秒)、1h (1 時間) などの単位を使用して時間値を指定することもできます。 | 500 | long |
greedy (scheduler) | greedy が有効で、以前の実行が 1 つ以上のメッセージをポーリングした場合、ScheduledPollConsumer は即座に再度実行されます。 | false | boolean |
initialDelay (scheduler) | 最初のポーリングが開始されるまでの時間 (ミリ秒単位)。60s (60 秒)、5m30s (5 分 30 秒)、1h (1 時間) などの単位を使用して時間値を指定することもできます。 | 1000 | long |
runLoggingLevel (scheduler) | コンシューマーはポーリング時に開始/完了のログ行を記録します。このオプションを使用すると、ログレベルを設定できます。 | TRACE | LoggingLevel |
scheduledExecutorService (scheduler) | コンシューマーに使用するカスタム/共有スレッドプールを設定できます。デフォルトでは、各コンシューマーに独自の単一スレッドのスレッドプールがあります。 | ScheduledExecutor Service | |
scheduler (scheduler) | camel-spring または camel-quartz2 コンポーネントから cron スケジューラーを使用します。 | none | ScheduledPollConsumer Scheduler |
schedulerProperties (scheduler) | カスタムスケジューラーまたは Quartz2 や Spring ベースのスケジューラーを使用する場合に、追加のプロパティーを設定します。 | Map | |
startScheduler (scheduler) | スケジューラーを自動起動するかどうか。 | true | boolean |
timeUnit (scheduler) | initialDelay および delay オプションの時間単位。 | MILLISECONDS | TimeUnit |
useFixedDelay (scheduler) | 固定遅延または固定レートを使用するかどうかを制御します。詳細は、JDK の ScheduledExecutorService を参照してください。 | true | boolean |