9.2. コンポーネントオプション
Azure ServiceBus コンポーネントは、以下に示す 25 のオプションをサポートしています。
名前 | 説明 | デフォルト | タイプ |
---|---|---|---|
amqpRetryOptions (common) | Service Bus クライアントの再試行オプションを設定します。指定しないと、デフォルトの再試行オプションが使用されます。 | AmqpRetryOptions | |
amqpTransportType (common) | Azure Service Bus とのすべての通信が発生するトランスポートの種類を設定します。デフォルト値は AmqpTransportType#AMQP です。 列挙値:
| AMQP | AmqpTransportType |
clientOptions (共通) | このビルダーから構築されたクライアントから送信される ClientOptions を設定し、特定のプロパティーのカスタマイズを有効にし、カスタムヘッダー情報の追加をサポートします。詳細は、ClientOptions のドキュメントを参照してください。 | ClientOptions | |
configuration (common) | コンポーネントの設定。 | ServiceBusConfiguration | |
proxyOptions (共通) | ServiceBusSenderAsyncClient に使用するプロキシー設定を設定します。プロキシーが設定されている場合は、AmqpTransportType#AMQP_WEB_SOCKETS をトランスポートタイプに使用する必要があります。 | ProxyOptions | |
serviceBusType (common) | 必須 実行するサービスバスの接続の種類。キューは、サブスクリプションベースのモデルの典型的なキューオプションとトピックです。 列挙値:
| queue | ServiceBusType |
bridgeErrorHandler (consumer) | consumer の Camel ルーティングエラーハンドラーへのブリッジを許可します。よって、consumer が受信メッセージなどの取得を試行している間に発生した例外は、メッセージとして処理され、ルーティングエラーハンドラーによって処理されます。デフォルトでは、consumer は org.apache.camel.spi.ExceptionHandler を使用して例外に対応し、WARN または ERROR レベルでログに記録され、無視されます。 | false | boolean |
consumerOperation (consumer) | consumer で使用する目的の操作を設定します。 列挙値:
| receiveMessages | ServiceBusConsumerOperationDefinition |
disableAutoComplete (consumer) | 受信メッセージのオートコンプリートと自動破棄を無効にします。デフォルトでは、正常に処理されたメッセージは \\{link ServiceBusReceiverAsyncClient#complete (ServiceBusReceivedMessage) completed} です。メッセージの処理時にエラーが発生した場合は、\\{link ServiceBusReceiverAsyncClient#abandon(ServiceBusReceivedMessage) abandoned} 放棄} です。 | false | boolean |
maxAutoLockRenewDuration (consumer) | ロックの自動更新を継続する時間を設定します。Duration#ZERO または null を設定すると、自動更新が無効になります。\\{link ServiceBusReceiveMode#RECEIVE_AND_DELETE RECEIVE_AND_DELETE} モードでは、自動更新は無効になっています。 | 5m | 期間 |
peekNumMaxMessages (consumer) | ピーク操作中にピークされるメッセージの最大数を設定します。 | Integer | |
prefetchCount (consumer) | レシーバーのプリフェッチカウントを設定します。\\{link ServiceBusReceiveMode#PEEK_LOCK PEEK_LOCK} モードと \\{link ServiceBusReceiveMode#RECEIVE_AND_DELETE RECEIVE_AND_DELETE} モードの両方で、デフォルト値は 1 です。プリフェッチは、アプリケーションが ServiceBusReceiverAsyncClient#receiveMessages () を使用して要求する前に、ローカルでメッセージをすぐに取得できるようにすることで、メッセージフローを高速化します。ゼロ以外の値を設定すると、その数のメッセージがプリフェッチされます。値をゼロに設定すると、プリフェッチがオフになります。 | int | |
receiverAsyncClient (consumer) | Autowired consumer がメッセージを消費するために、receiverAsyncClient を設定します。 | ServiceBusReceiverAsyncClient | |
serviceBusReceiveMode (consumer) | 受信機の受信モードを設定します。 列挙値:
| PEEK_LOCK | ServiceBusReceiveMode |
subQueue (consumer) | 接続先の SubQueue のタイプを設定します。 列挙値:
| SubQueue | |
subscriptionName (consumer) | リッスンするトピックのサブスクリプションの名前を設定します。topicOrQueueName および serviceBusType=topic も設定する必要があります。このプロパティーは、serviceBusType=topic であり、consumer が使用されている場合に必要です。 | 文字列 | |
lazyStartProducer (producer) | 最初のメッセージで producer をレイジーに起動すべきかどうか。レイジーに起動することで、起動時に producer が失敗し、それによりルートが失敗する可能性がある状況で、CamelContext およびルートの起動を許可します。レイジーな起動を延期すると、Camel のルーティングエラーハンドラー経由でメッセージのルーティング中に起動の失敗を処理できます。最初のメッセージが処理されるときに、producer の作成および起動に若干時間がかかり、合計処理時間が長くなる可能性があることに注意してください。 | false | boolean |
ProducerOperation (producer) | producer で使用する目的の操作を設定します。 列挙値:
| sendMessages | ServiceBusProducerOperationDefinition |
scheduledEnqueueTime (producer) | メッセージが Service Bus キューまたはトピックに表示される OffsetDateTime を設定します。 | OffsetDateTime | |
senderAsyncClient (producer) | Autowired producer で使用される SenderAsyncClient を設定します。 | ServiceBusSenderAsyncClient | |
serviceBusTransactionContext (producer) | サービス中のトランザクションを表します。このオブジェクトにはトランザクション ID のみが含まれます。 | ServiceBusTransactionContext | |
autowiredEnabled (advanced) | 自動ワイヤリングが有効になっているかどうか。これは、コンポーネントで設定される一致するタイプのインスタンスが 1 つあるかどうかを検出するためにレジストリーを検索することで、自動ワイアリングオプションに使用されます (オプションは自動ワイアとマーク付けされる必要があります)。これは、JDBC データソース、JMS 接続ファクトリー、AWS クライアントなどの自動設定に使用できます。 | true | boolean |
connectionString (セキュリティー) | Service Bus 名前空間または特定の Service Bus リソースの接続文字列を設定します。 | 文字列 | |
fullyQualifiedNamespace (セキュリティー) | サービスバスの完全修飾名前空間。 | 文字列 | |
tokenCredential (セキュリティー) | com.azure.identity に実装されている、Azure AD 認証用の TokenCredential。 | TokenCredential |