第 17 章 JMS リソースアダプタのプロパティーのリファレンス
この章では、Message QueueTM の JMS リソースアダプタ (JMS RA) の設定プロパティーについて説明します。この JMS リソースアダプタを使用すると、標準的な J2EE コネクタアーキテクチャー (JCA) により、Sun Java SystemTM Message Queue を任意の J2EE 1.4 アプリケーションサーバーと統合できます。リソースアダプタをプリケーションサーバーに組み込むと、そのアプリケーションサーバーに配備したアプリケーションが、Message Queue を使用して JMS メッセージを送受信できるようになります。
Message Queue の JMS リソースアダプタでは、次の 3 つの JavaBean コンポーネントを介して設定プロパティーが公開されます。
これらのエンティティーのプロパティー値を設定するには、リソースアダプタの設定用と配備用、および MDB の配備用にアプリケーションサーバーによって提供されるツールを使用します。
この章では、Message Queue の JMS リソースアダプタの設定プロパティーを一覧表示して説明します。この章は、次の節から構成されています。
ResourceAdapter JavaBean
ResourceAdapter 設定では、JMS リソースアダプタのデフォルト動作を設定します。表 17–1 で、この JavaBean を設定するためのプロパティーを一覧表示して説明します。
表 17–1 リソースアダプタのプロパティー
|
プロパティー
|
データ型
|
デフォルト値
|
説明
|
|
addressList
|
文字列
|
mq://localhost:7676/jms
|
(必須) Message Queue サービスに接続するためのメッセージサービスのアドレス
次に示す connectionURL と同じものです。いずれか一方を設定する必要があります。
|
|
connectionURL
|
文字列
|
mq://localhost:7676/jms
|
Message Queue サービスに接続するためのメッセージサービスのアドレス
上記の addressList と同じものです。いずれか一方を設定する必要があります。
|
|
userName
|
文字列
|
guest
|
(必須) Message Queue サービスに接続するためのデフォルトユーザー名
|
|
password
|
文字列
|
guest
|
(必須) Message Queue サービスに接続するためのデフォルトパスワード
|
|
addressListBehavior
|
文字列
|
PRIORITY
|
Message Queue サービスに接続を試行する順序。
注 –
接続障害後の再接続の試行は、接続がエラーになったブローカから始まり、このプロパティーに設定された値にかかわらず、アドレスリストを順番に処理します。
|
|
addressListIterations
|
整数
|
1
|
接続の確立または再確立を試行する際にアドレスリストを繰り返す回数
|
|
reconnectEnabled
|
ブール
|
false
|
失われた接続の再確立を試行するかどうか
|
|
reconnectAttempts
|
整数
|
6
|
アドレスリスト内の次のアドレスに移る前に、各アドレスに再接続を試行する回数
|
|
reconnectInterval
|
倍長整数
|
30000
|
再接続を試行する間隔 (ミリ秒単位)
|
ManagedConnectionFactory JavaBean
管理対象接続ファクトリでは、リソースアダプタがメッセージ駆動型 Bean に提供する接続の定義を行います。表 17–2 では、ManagedConnectionFactory JavaBean のプロパティーを示します。これらのプロパティーが設定された場合、ResourceAdapter JavaBean の対応するプロパティーは上書きされます。
表 17–2 管理対象接続ファクトリのプロパティー
|
プロパティー
|
データ型
|
デフォルト値
|
説明
|
|
addressList
|
文字列
|
ResourceAdapter JavaBean (表 17–1 を参照) から継承
|
Message Queue サービスに接続するためのメッセージサービスのアドレスのリスト
|
|
userName
|
文字列
|
guest
|
(任意指定) Message Queue サービスに接続するためのユーザー名
|
|
password
|
文字列
|
guest
|
(任意指定) Message Queue サービスに接続するためのパスワード
|
|
clientID
|
文字列
|
なし
|
Message Queue サービスに接続するためのクライアント識別子
|
|
addressListBehavior
|
文字列
|
PRIORITY
|
Message Queue サービスに接続を試行する順序。
注 –
接続障害後の再接続の試行は、接続がエラーになったブローカから始まり、このプロパティーに設定された値にかかわらず、アドレスリストを順番に処理します。
|
|
addressListIterations
|
整数
|
1
|
接続の確立または再確立を試行する際にアドレスリストを繰り返す回数
|
|
reconnectEnabled
|
ブール
|
false
|
失われた接続の再確立を試行するかどうか
|
|
reconnectAttempts
|
整数
|
6
|
アドレスリスト内の次のアドレスに移る前に、各アドレスに再接続を試行する回数
|
|
reconnectInterval
|
倍長整数
|
30000
|
再接続を試行する間隔 (ミリ秒単位)
|
ActivationSpec JavaBean
表 17–3に、ActivationSpec JavaBean の設定可能なプロパティーを示します。アプリケーションサーバーは、これらのプロパティーを使用してメッセージ終端をアクティブにし、それらとメッセージ駆動型 Bean を関連付けるようにリソースアダプタに命令します。
表 17–3 アクティブ化仕様のプロパティー
|
プロパティー
|
データ型
|
デフォルト値
|
説明
|
|
addressList [Message Queue JMS リソースアダプタに固有のプロパティー]
|
文字列
|
ResourceAdapter JavaBean から継承
|
(任意指定) Message Queue サービスに接続するためのメッセージサービスのアドレス
|
|
destination [標準的な Enterprise JavaBean (EJB) および J2EE コネクタアーキテクチャー (CA) のプロパティー]
|
文字列
|
なし
|
(必須) メッセージを消費する送信先の名前
値は、Message Queue の送信先管理対象オブジェクトの destinationName プロパティーの値にする必要があります。
|
|
destinationType
|
文字列
|
なし
|
(必須) destination プロパティーで指定した次のいずれかの送信先のタイプ。
javax.jms.Queue: キュー送信先
javax.jms.Topic: トピック送信先
|
|
messageSelector
|
文字列
|
なし
|
(任意指定) コンシューマに配信されるメッセージのフィルタリングに使用するメッセージセレクタ
|
|
subscriptionName
|
文字列
|
なし
|
永続サブスクリプションの名前
subscriptionDurability が Durable に設定されている場合は、このプロパティーを設定する必要があります。
|
|
subscriptionDurability
|
文字列
|
NonDurable
|
トピック送信先のコンシューマが永続的であるかどうか。
Durable: 永続コンシューマ
NonDurable: 永続的でないコンシューマ
このプロパティーは、destinationType をjavax.jms.Topic に設定した場合にのみ有効です。また、永続的でないサブスクリプションでは任意指定であり、永続サブスクリプションでは必須です。Durable に設定した場合は、clientID プロパティーと subscriptionName プロパティーも設定する必要があります。
|
|
clientId
|
文字列
|
なし
|
Message Queue サービスに接続するためのクライアント ID
subscriptionDurability を Durable に設定した場合は、このプロパティーを設定する必要があります。
|
|
acknowledgeMode
|
文字列
|
Auto-acknowledge
|
(任意指定) 次のいずれかの通知モード。
Auto-acknowledge: Auto-acknowledge モード
Dups-ok-acknowledge: Dups-OK-acknowledge モード
|
|
customAcknowledgeMode
|
文字列
|
なし
|
MDB メッセージの消費に使用する通知モード
有効な値は、No_acknowledge または NULL です。
no-acknowledge モードは、処理済みでも永続的でもないトピックサブスクリプションのみに使用できます。処理済みサブスクリプションか永続サブスクリプションでこの設定を使用すると、サブスクリプションのアクティブ化はエラーになります。
|
|
endpointExceptionRedeliveryAttempts
|
整数
|
6
|
メッセージ配信中に MDB で例外がスローされたとき、メッセージを再配信する回数
|
|
sendUndeliverableMsgsToDMQ
|
ブール
|
true
|
MDB で実行時例外がスローされ、再配信回数が endpointExceptionRedeliveryAttempts の値を超えたとき、デッドメッセージキューにメッセージを配置するかどうか
false に設定した場合、Message Queue ブローカは、同一 MDB も含めた有効なコンシューマにメッセージを再配信しようとします。
|
