第5章 SSL 設定オプション
本章では、AMQ OpenWire JMS で利用可能な設定オプションについて説明します。
JMS 設定オプションは、接続 URI でクエリーパラメーターとして設定されます。詳細は、「接続 URI」 を参照してください。
5.1. JMS オプション リンクのコピーリンクがクリップボードにコピーされました!
リンクのコピーリンクがクリップボードにコピーされました!
- jms.username
- クライアントが接続を認証するために使用するユーザー名。
- jms.password
- クライアントが接続を認証するために使用するパスワード。
- jms.clientID
- クライアントが接続に適用するクライアント ID。
- jms.closeTimeout
- JMS 終了操作のタイムアウト (ミリ秒単位)。デフォルトは 15000 (15 秒) です。
- jms.connectResponseTimeout
- JMS 接続操作のタイムアウト (ミリ秒単位)。デフォルトは 0 で、タイムアウトなしを意味します。
- jms.sendTimeout
- JMS 送信操作のタイムアウト (ミリ秒単位)。デフォルトは 0 で、タイムアウトなしを意味します。
- jms.checkForDuplicates
- 有効な場合は、重複メッセージを無視します。これはデフォルトで有効になっています。
- jms.disableTimeStampsByDefault
- 有効でなければ、タイムスタンプのメッセージは使用しないでください。これはデフォルトで無効になっています。
- jms.useAsyncSend
- 有効にすると、確認応答を待たずにメッセージを送信します。これはデフォルトで無効になっています。
- jms.alwaysSyncSend
- 有効にすると、送信は全配信モードで承認を待ちます。これはデフォルトで無効になっています。
- jms.useCompression
- 有効にすると、メッセージの本文を圧縮します。これはデフォルトで無効になっています。
- jms.useRetroactiveConsumer
- 有効にすると、非永続サブスクライバーはサブスクリプションの開始前に公開されたメッセージを受信できます。これはデフォルトで無効になっています。
prefetch ポリシーオプション
prefetch ポリシーは、各 MessageConsumer がリモートピアから取得し、ローカルの「prefetch」バッファーに保持されるメッセージ数を決定します。
- jms.prefetchPolicy.queuePrefetch
- キュー用に事前にフェッチするメッセージの数。デフォルトは 1000 です。
- jms.prefetchPolicy.queueBrowserPrefetch
- キューブラウザー用に事前にフェッチするメッセージの数。デフォルトは 500 です。
- jms.prefetchPolicy.topicPrefetch
- 非永続トピック用に事前にフェッチするメッセージの数。デフォルトは 32766 です。
- jms.prefetchPolicy.durableTopicPrefetch
- 永続トピック用に事前にフェッチするメッセージの数。デフォルトは 100 です。
- jms.prefetchPolicy.all
- これは、すべての事前にフェッチされた値を 1 度に設定するために使用できます。
prefetch の値は、キューの複数のコンシューマーへのメッセージの分散に影響します。値が大きいと、各コンシューマーに一度に送信されるバッチが大きくなる可能性があります。コンシューマーが異なるレートで動作している場合に、より均等にラウンドロビンの分散を実現するには、小さい値を使用します。
再配信ポリシーオプション
再配信ポリシーは、クライアント上で再配信されたメッセージの処理方法を制御します。
- jms.redeliveryPolicy.maximumRedeliveries
- メッセージがデッドレターキューに送信される前に再配信を試行する回数。デフォルトは 6 で、-1 は無制限を意味します。
- jms.redeliveryPolicy.redeliveryDelay
-
再配信の試行間隔 (ミリ秒単位)。
initialRedeliveryDelayが 0 の場合に使用されます。デフォルトは 1000 (1 秒) です。 - jms.redeliveryPolicy.initialRedeliveryDelay
- 最初の再配信試行までの時間 (ミリ秒単位)。デフォルトは 1000 (1 秒) です。
- jms.redeliveryPolicy.maximumRedeliveryDelay
-
再配信の試行間隔の最大時間 (ミリ秒単位)。これは、
useExponentialBackOffが有効な場合に使用されます。デフォルトは 1000 (1 秒) です。-1 は無制限を意味します。 - jms.redeliveryPolicy.useExponentialBackOff
- 有効にすると、後続の試行ごとに再配信の遅延を増やします。これはデフォルトで無効になっています。
- jms.redeliveryPolicy.backOffMultiplier
- 再配信の遅延を増やす乗数。デフォルトは 5 です。
- jms.redeliveryPolicy.useCollisionAvoidance
- 有効にすると、再配信の遅延を少し上または下に調整して、衝突を回避します。これはデフォルトで無効になっています。
- jms.redeliveryPolicy.collisionAvoidanceFactor
- 再配信遅延を調整するための乗数。デフォルトは 0.15 です。
- nonBlockingRedelivery
- 有効にすると、行頭ブロックを回避するために、順不同の再配信を許可します。これはデフォルトで無効になっています。