172.4.2. クエリーパラメーター（42 パラメーター）:

joinTransaction (common)

camel-jpa コンポーネントはデフォルトでトランザクションに参加します。このオプションを使用するとこれをオフにすることができます。たとえば、LOCAL_RESOURCE を使用し、結合トランザクションが JPA プロバイダーと動作しません。このオプションは、すべてのエンドポイントに設定する代わりに、JpaComponent でグローバルに設定することもできます。

true

boolean

maximumResults (common)

Query で取得する結果の最大数を設定します。

-1

int

namedQuery (common)

名前付きクエリーを使用するには、以下を実行します。

文字列

nativeQuery (common)

カスタムのネイティブクエリーを使用します。ネイティブクエリーを使用する場合も resultClass オプションを使用することが望ましい場合があります。

文字列

パラメーター （共通）

このキーと値のマッピングは、クエリーパラメーターの構築に使用されます。キーは指定された JPA クエリーの名前付きパラメーターで、選択する対応する有効な値である java.util.Map 汎用型 java.util.Map が使用されることが予想されます。プロデューサーに使用される場合、Simple 式をパラメーター値として使用できます。これにより、メッセージボディー、ヘッダーなどからパラメーター値を取得できます。

マップ

persistenceUnit (common)

デフォルトで使用される JPA 永続ユニットが 必要です。

Camel

文字列

クエリー （共通）

カスタムクエリーを使用するには、以下を行います。

文字列

resultClass (common)

返されるペイロードのタイプを定義します（ここでは entityManager.createNativeQuery(nativeQuery)ではなく entityManager.createNativeQuery(nativeQuery)を呼び出します）。このオプションを指定しないと、オブジェクトアレイを返します。データの消費時にネイティブクエリーと併用する場合にのみ影響があります。

class<?>

sharedEntityManager (common)

コンシューマー/プロデューサーに Spring の SharedEntityManager を使用するかどうか。ほとんどの場合、joinTransaction は EXTENDED EntityManager ではないため、false に設定する必要があります。

false

boolean

bridgeErrorHandler (consumer)

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

false

boolean

consumeDelete (consumer)

true の場合、エンティティーは消費後に削除されます。false の場合は、エンティティーは削除されません。

true

boolean

consumeLockEntity (consumer)

ポーリングからの結果を処理する間に、各エンティティー bean に排他ロックを設定するかどうかを指定します。

true

boolean

deleteHandler (consumer)

コンシューマーがエクスチェンジの処理が完了した後にカスタム DeleteHandler を使用して行を削除するには、以下を実行します。

Object>

lockModeType (consumer)

コンシューマーでロックモードを設定します。

PESSIMISTIC_WRITE

LockModeType

maxMessagesPerPoll (consumer)

ポーリングごとに収集するメッセージの最大数を定義する整数値。デフォルトでは、最大値は設定されません。サーバーを起動すると、数千ものメッセージをポーリングしないようにできます。無効にするには、0 または negative の値を設定します。

int

preDeleteHandler (consumer)

コンシューマーがエンティティーを読み取った後にカスタム Pre-DeleteHandler を使用して行を削除するには、以下を行います。

Object>

sendEmptyMessageWhenIdle (consumer)

ポーリングコンシューマーがファイルをポーリングしなかった場合、このオプションを有効にして、代わりに空のメッセージ (ボディーなし) を送信できます。

false

boolean

skipLockedEntity (consumer)

ロックで NOWAIT を使用し、警告なしでエンティティーをスキップするかどうかを設定します。

false

boolean

トランザクション （コンシューマー）

バッチ全体が処理されたときにすべてのメッセージがコミットまたはロールバックされるトランザクションモードでコンシューマーを実行するかどうか。デフォルトの動作(false)は、以前に処理されたすべてのメッセージをコミットし、最後に失敗したメッセージのみをロールバックします。

false

boolean

exceptionHandler (consumer)

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

ExceptionHandler

exchangePattern (consumer)

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

ExchangePattern

pollStrategy (consumer)

プラグ可能な org.apache.camel.PollingConsumerPollingStrategy を使用すると、エクスチェンジが作成され、Camel でルーティングされる前に、通常はポーリング操作中に発生するエラー処理を制御するカスタム実装が提供できます。

PollingConsumerPoll Strategy

flushOnSend (producer)

エンティティー Bean が永続化された後に EntityManager をフラッシュします。

true

boolean

削除 （プロデューサー）

entityManager.remove(entity)を使用することを示します。

false

boolean

useExecuteUpdate (producer)

プロデューサーがクエリーを実行する際に executeUpdate（）を使用するかどうかを設定します。INSERT、UPDATE、または DELETE ステートメントを名前付きクエリーとして使用する場合は、このオプションを 'true' に指定する必要があります。

ブール値

usePassedInEntityManager (producer)

true に設定すると、Camel はコンポーネント/エンドポイントの設定済みのエンティティーマネージャーの代わりに、ヘッダー JpaConstants.ENTITYMANAGER から EntityManager を使用します。これにより、エンドユーザーは使用中のエンティティーマネージャーを制御できます。

false

boolean

usePersist (producer)

entityManager.merge（entity の代わりに entityManager.persist(entity)を使用することを示します。注記： entityManager.persist(entity)は、分離されたエンティティーでは動作しません（EntityManager は INSERT クエリーの代わりに UPDATE を実行する必要がある場合）。

false

boolean

entityManagerProperties (advanced)

使用するエンティティーマネージャーの追加プロパティー。

マップ

同期 （詳細）

同期処理を厳密に使用するか、Camel が非同期処理を使用できるようにするかを設定します（サポートされている場合）。

false

boolean

backoffErrorThreshold (scheduler)

backoffMultipler が開始する前に発生する必要がある後続のエラーポーリング (エラーによって失敗した) の数。

int

backoffIdleThreshold (scheduler)

backoffMultipler が開始する前に発生する必要がある後続のアイドルポーリングの数。

int

backoffMultiplier (scheduler)

後続のアイドル状態/エラーが連続して発生した場合に、スケジュールされたポーリングコンシューマーのバックオフを許可します。乗数は、実際に次の試行が行われる前にスキップされるポーリングの数です。このオプションが使用されている場合は、backoffIdleThreshold や backoffErrorThreshold も設定する必要があります。

int

遅延 （スケジューラー）

次のポーリングまでの時間 (ミリ秒単位)。また、60 秒（60 秒）、5m30s（5 分と 30 秒）、および 1h（1 時間）などの単位を使用して時間の値を指定することもできます。

500

Long

greedy (scheduler)

greedy が有効で、以前の実行が 1 つ以上のメッセージをポーリングした場合、ScheduledPollConsumer は即座に再度実行されます。

false

boolean

initialDelay (scheduler)

最初のポーリングが開始されるまでの時間 (ミリ秒単位)。また、60 秒（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 ベースのスケジューラーを使用する場合に追加のプロパティーを設定します。

マップ

startScheduler (scheduler)

スケジューラーを自動起動するかどうか。

true

boolean

timeUnit (scheduler)

initialDelay および delay オプションの時間単位。

ミリ秒

TimeUnit

useFixedDelay (scheduler)

固定遅延または固定レートを使用するかどうかを制御します。詳細は、JDK の ScheduledExecutorService を参照してください。

true

boolean