A JMSリソース定義要素リファレンス
Oracle WebLogic Serverでは、宛先および接続ファクトリの要素を使用してJMSリソースを構成できます。これらのJMSリソース定義を使用すると、アプリケーションを最小管理構成でJava EE環境にデプロイできます。
ノート:
JMSリソースを定義する定義ではなく、システム・モジュールを使用することを通常お薦めします。システム・モジュールが構成されたリソースは、アプリケーションの変更、再構築および再デプロイを必要とせずに追加、削除および変更できます。「JMSシステム・モジュールの構成」を参照してください。
次の項では、Java EE JMSリソース定義要素およびプロパティについて説明します。
Java EEリソース定義を使用したJMSリソースの定義
@JMSConnectionFactoryDefinition
および@JMSDestinationDefinition
アノテーションを使用するか、<jms-destination>
および<jms-connection-factory>
要素を使用して、JMSリソースを定義できます。これらのJMSリソース定義を使用すると、アプリケーションを最小管理構成でJava EE環境にデプロイできます。
ノート:
アプリケーションがデプロイされた後で、アプリケーションのスコープ内で構成されたJMSリソースを変更することはできません。また、アプリケーション・モジュールで作成された宛先を直接削除するオプションはありません。アプリケーションをアンデプロイしても、宛先は削除されません。これらの理由から、かわりにJMSシステム・モジュールを使用して接続ファクトリと宛先を構成することをお薦めします。「JMSシステム・モジュールの構成」を参照してください。アノテーションを使用するリソース定義
Webモジュール、EJBモジュールまたはアプリケーション・クライアント・モジュールの内部で、アノテーション@JMSConnectionFactoryDefinition
および@JMSDestinationDefinitions
を定義できます。これらのクラス内部では、アノテーションを使用してリソースを定義することもできます。
-
application.xml
デプロイメント記述子の<library-directory>要素で定義されたライブラリで定義されたクラス -
EJB jarファイルまたは.warファイルのClass-pathエントリによって参照されている.jarファイル内のクラス
これが定義されると、コンポーネントは@Resourceアノテーションのlookup要素を使用するか、resource-refデプロイメント・ディスクリプタ要素のlook-up要素を使用して、リソースを参照できます。
例A-1 例: JMS接続ファクトリの定義
@JMSConnectionFactoryDefinition( name="java:app/MyJMSConnectionFactory", interfaceName="javax.jms.QueueConnectionFactory").
例A-2 例: JMS宛先の定義
@JMSDestinationDefinition( name="java:app/MyJMSQueue", interfaceName="javax.jms.Queue", destinationName="myQueue1")
リソース定義で使用できる要素とプロパティの詳細は、「JMSリソース定義要素リファレンス」を参照してください
デプロイメント記述子におけるリソース定義
アノテーションを使用するかわりに、デプロイメント記述子内で<jms-destination
>および<jms-connection-factory>
要素を使用して、リソースを定義できます。
JMSコネクション・ファクトリの定義
ejb-jar.xml
またはweb.xml
デプロイメント記述子内で、jms-connection-factory
要素を使用して、JMS宛先リソースを定義できます。接続ファクトリが作成され、指定されるネームスペースに基づいて適切な名前コンテキストにバインドされます。
次の例は、場所java:app/MyJMSConnectionFactory
でJNDIにバインドされた接続ファクトリを定義します。
<jms-connection-factory> <description>Sample JMS ConnectionFactory definition</description> <name>java:app/MyJMSConnectionFactory</name> <interface-name>javax.jms.QueueConnectionFactory</interface-name> <user>scott</user> <password>tiger</password> <client-id>MyClientId</client-id> <property> <name>Property1</name> <value>10</value> </property> <property> <name>Property2</name> <value>20</value> </property> <transactional>false</transactional> <max-pool-size>30</max-pool-size> <min-pool-size>20</min-pool-size> </jms-connection-factory>
jms-connection-factory
要素やその属性の詳細は、http://xmlns.jcp.org/xml/ns/javaee/javaee_7.xsdにあるスキーマを参照してください
JMS宛先の定義
ejb-jar.xml
またはweb.xmlデプロイメント記述子内で、jms-destination
要素を使用して、JMS宛先リソースを定義できます。宛先を作成し、指定されたネームスペースに基づいて、適切なネーミング・コンテキストにバインドします。
次の例は、場所java:app/MyJMSDestination:
でJNDIにバインドされたキュー宛先myQueue1を定義します
<jms-destination> <description>JMS Destination definition</description> <name>java:app/MyJMSDestination</name> <interface-name>javax.jms.Queue</interface-name> <destination-name>myQueue1</destination-name> <property> <name>Property1</name> <value>10</value> </property> <property> <name>Property2</name> <value>20</value> </property> </jms-destination>
jms-destination要素やその属性の詳細は、http://xmlns.jcp.org/xml/ns/javaee/javaee_7.xsdにあるスキーマを参照してください
JMSリソース定義の考慮事項とベスト・プラクティス
新しいアノテーションを使用して定義されたリソースの考慮事項を以下に示します。
-
次に示す許可されたJNDIネームスペースのいずれかにJMSリソースを定義します。
-
java:comp
-
java:module
-
java:app
-
java:global
-
-
JNDI名がjava:で始まるが、前述のネームスペース接頭辞のいずれでも始まっていない場合は、デプロイメント時に例外が発生します。
-
JNDI名が
java:
で始まらない場合、宛先または接続ファクトリはjava:comp/env namespace
で定義されます。たとえば、jms/myDestination
という形式のJNDI名は、java:comp/env/jms/myDestination
と同じとみなされます。
-
WebLogic Serverでは、アプリケーションは宛先を
application.xml
デプロイメント記述子のjava:app
およびjava:global
ネームスペースで、または、Webモジュール、EJBモジュールまたはアプリケーション・クライアント・モジュール内のクラス以外のアプリケーション・パッケージにあるクラス上のアノテーションを使用して定義できます。
-
@JMSDestinationDefinition
を使用して定義された宛先は、内部的に共通分散宛先(キューまたはトピック)として作成されます。デフォルトでは、タイプjavax.jms.Topic
の@JMSDestinationDefinition (interfaceNameを指定)
を使用して作成される共通分散トピックの「転送ポリシー」オプションの値は「パーティション化」になります。アプリケーション・デプロイメント時に、値を「レプリケート」に指定できます。ただし、リソース・グループまたはリソース・グループ・テンプレートでForwarding Policyを「replicated」として使用することは、適格性チェックで制限されます。『Oracle WebLogic Server JMSアプリケーションの開発』の分散トピックのベストプラクティスに関する項を参照してください。ノート:
WebLogic Server Multitenantドメイン・パーティション、リソース・グループ、リソース・グループ・テンプレートおよび仮想ターゲットは、WebLogic Server 12.2.1.4.0で非推奨になり、次のリリースで削除されます。
-
@JMSDestinationDefinition
を使用してキューを定義するアプリケーションがアンデプロイされている場合、永続ストアは受信または消費されていないメッセージを保持します。これらのメッセージはアプリケーションの再デプロイ時に、宛先の消費者が利用できます。
詳細は、Java(TM) EE7仕様APIのアノテーション・タイプJMSConnectionFactoryDefinitionに関する項およびアノテーション・タイプJMSDestinationDefinitionに関する項を参照してください。
JMSコネクション・ファクトリの定義要素とプロパティ
この項では、Java(TM) EE7仕様APIドキュメントに記載されているリソース定義の要素について説明します。アノテーション・タイプJMSConnectionFactoryDefinitionに関する項を参照してください。
次の例では、@JMSConnectionFactoryDefinition
アノテーションを使用して接続ファクトリを定義しています。
@JMSConnectionFactoryDefinition(
name="java:global/jms/demoConnectionFactory",
className= "javax.jms.ConnectionFactory",
description="Sample description for Connection Factory",
clientId="client_Id01",
transactional=true,
properties= {"UserName=myuser", "delivery-mode=Persistent", "load-balancing-enabled=true"}
JMSアプリケーション・モジュールの要素定義の詳細は、http://xmlns.oracle.com/weblogic/weblogic-jms/1.7/weblogic-jms.xsd にあるweblogic-jms.xsdスキーマを参照してください
表A-1 @JMSConnectionFactoryDefinition要素
@JMSConnectionFactoryDefinition要素にある要素 | JMSアプリケーション・モジュールにある同等の要素 | 型 | 説明 |
---|---|---|---|
name |
jndi-name |
String |
定義されるJMS接続ファクトリのJNDI名。 ノート: これは必須要素です。 |
description |
notes |
String |
接続ファクトリの説明。 |
clientId |
clientId |
String |
接続に使用されるクライアントID。 |
transactional |
transaction-paramsxa-connection-factory-enabled |
Boolean |
接続がトランザクションに参加するかどうかを指定します。このプロパティの設定を、 false にした場合、接続はトランザクションに参加しません。 デフォルトはTrue です。
|
resourceAdapter |
なし |
String |
リソース・アダプタの名前。 |
className |
なし |
String |
値は無視されます。 |
InterfaceName |
なし |
String |
値は無視されます。 |
maxPoolSize |
なし |
integer |
値は無視されます。 |
minPoolSize |
なし |
integer |
値は無視されます。 |
user |
なし |
String |
値は無視されます。 |
password |
なし |
String |
値は無視されます。 |
JMS接続ファクトリ・プロパティ
ノート:
この項で定義されるプロパティは、接続ファクトリ定義がアダプタを指定しない場合のみ適用されます。アダプタが指定されると、アダプタに対して一意であるプロパティが考慮されます。表A-2 @JMSConnectionFactoryDefinitionプロパティ
@JMSConnectionFactoryDefinitionプロパティ | JMSアプリケーション・モジュールにある同等の要素 | 型 | 説明 |
---|---|---|---|
name |
name |
Sting |
接続ファクトリの名前。指定しない場合、名前は |
jms-server-name |
sub-deployment-name |
Sting |
リソースに対してターゲットとして指定されるJMSサーバー。アプリケーションで指定された |
default-targeting-enabled |
default-targeting-enabled |
boolean |
|
表A-3 デフォルト・メッセージ配信のための@JMSConnectionFactoryDefinitionプロパティ
@JMSConnectionFactoryDefinitionプロパティ | JMSアプリケーション・モジュールにある同等のdefault-delivery-params要素 | 型 | 説明 |
---|---|---|---|
default-delivery-mode |
default-delivery-mode |
String |
定義される接続ファクトリを使用してプロデューサから送信されるすべてのメッセージに割り当てられる配信モード。受け入れられる値: |
default-time-to-deliver |
default-time-to-deliver |
String |
メッセージが生成されてからその宛先で表示できるようになるまでの遅延時間(ミリ秒) |
default-time-to-live |
default-time-to-live |
Long |
メッセージの最大存在時間を示すミリ秒数。この値は、メッセージに優先度が明示的に定義されていない場合に使用されます。 |
default-priority |
default-priority |
integer |
メッセージに優先度が明示的に定義されていない場合に使用するデフォルトの優先度。 |
default-redelivery-delay |
default-redelivery-delay |
Long |
ロールバックまたは回復されたメッセージが再配信されるまでの遅延時間(ミリ秒)。 |
default-compression-threshold |
default-compression-threshold |
integer |
シリアライズされたメッセージ本文のバイト数。任意のメッセージがこの制限を超過すると、そのメッセージがJMSメッセージ・プロデューサまたはコンシューマによって送信または受信されたときに、メッセージが圧縮されます |
default-unit-of-order |
default-unit-of-order |
String |
この接続ファクトリのデフォルトの順序単位プロデューサ。 オプション:「システム生成」および「ユーザー生成」 |
send-timeoutr |
send-timeoutr |
Long |
宛先に、送信されようとしているメッセージ用に利用できる領域が十分にない(割当てがない)場合に、送信側が待機する最長時間(ミリ秒)。 |
これらのプロパティの詳細は、Oracle WebLogic Server管理コンソール・オンライン・ヘルプ.のJMS接続ファクトリ: 構成: デフォルト配信を参照してください
表A-4 @JMSConnectionFactoryDefinitionクライアント・プロパティ
@JMSConnectionFactoryDefinitionプロパティ | JMSアプリケーション・モジュールにある同等のclient-params要素 | 型 | 説明 |
---|---|---|---|
client-id-policy |
client-id-policy |
String |
複数のJMS接続が同じクライアントIDを使用できるかどうか。有効なオプションは、 |
subscription-sharing-policy |
subscription-sharing-policy |
String |
接続上のサブスクリプション共有ポリシー。 有効なオプションは、 |
acknowledge-policy |
acknowledge-policy |
String |
|
allow-close-in-onMessage |
allow-close-in-onMessage |
Boolean |
false です。接続ファクトリがJMSシステム・モジュール内、またはアプリケーションをスコープとするモジュール内に作成された場合、allow-close-in-onMessage のデフォルト値はtrue です。
|
messages-maximum |
messages-maximum |
int |
非同期セッション向けに存在でき、メッセージ・リスナーにまだ渡されていないメッセージの最大数 |
multicast-overrun-policy |
multicast-overrun-policy |
String |
未処理のマルチキャスト・メッセージ数が 有効なオプションは、 |
synchronous-prefetch-mode |
synchronous-prefetch-mode |
String |
同期コンシューマが1回のサーバー・アクセスでメッセージ(つまり、サーバーからクライアントに送られるメッセージ)をプリフェッチするかどうか。 有効なオプションは、 |
reconnect-policy |
reconnect-policy |
String |
サーバーとのネットワーク接続が失われた後、またはサーバーの再起動時に、明示的および暗黙的にリフレッシュされるJMSクライアントのタイプ。 有効なオプションは、 |
reconnect-blocking-millis |
reconnect-blocking-millis |
Long |
同期JMSコールが、JMSクライアント上で進行中の再接続を諦める前に、コール元スレッドをブロックする時間の最大長(単位はミリ秒)。 |
total-reconnect-period-millis |
total-reconnect-period-millis |
Long |
最初のネットワーク切断、または最後の同期呼出しの試行のうち、いずれか最近に起こった方の後に、JMSクライアント(特に非同期コンシューマ)が、再試行を放棄せずサーバーに再接続しようとし続ける最長時間(ミリ秒)。 |
これらのプロパティの詳細は、Oracle WebLogic Server管理コンソール・オンライン・ヘルプのJMS接続ファクトリ: 構成: クライアントを参照してください。
表A-5 @JMSConnectionFactoryDefinitionトランザクション・プロパティ
@JMSConnectionFactoryDefinitionプロパティ | JMSアプリケーション・モジュールにある同等のtransaction-params要素 | 型 | 説明 |
---|---|---|---|
transaction-timeout |
transaction-timeout |
Long |
接続ファクトリで作成された接続上のすべてのトランザクションのタイムアウト値(秒)。 このプロパティは、transactional 要素がtrue に設定された場合のみ設定します。
|
これらのプロパティの詳細は、『Oracle WebLogic Server Administration Consoleオンライン・ヘルプ』のJMS接続ファクトリ: 構成: トランザクションに関する項およびJMS接続ファクトリ: 構成: フロー制御 に関する項を参照してください。
表A-6 @JMSConnectionFactoryDefinitionフロー制御プロパティ
@JMSConnectionFactoryDefinitionプロパティ | JMSアプリケーション・モジュールにある同等のflow-control-params要素 | 型 | 説明 |
---|---|---|---|
flow-minimum |
flow-minimum |
integer |
しきい値の条件に達したプロデューサで許可される秒当たりの最大メッセージ数。プロデューサがフロー制御されている場合、秒当たりFlowMaximumに指定されたメッセージ数よりも処理を高速化できません。 |
flow-maximum |
flow-maximum |
integer |
しきい値の条件に達したプロデューサで許可される秒当たりの最小メッセージ数。これはプロデューサのフロー制限の下限値。つまり、フロー制限がFlowMinimumに達したプロデューサの処理速度はWebLogic JMSによりそれ以上落とされません。 |
flow-interval |
flow-interval |
integer |
プロデューサがフローをFlowMaximumのメッセージ数からFlowMinimumに、あるいはその反対に調節するときの調節期間の秒数。 |
flow-steps |
flow-steps |
integer |
プロデューサが「最大フロー」のメッセージ数から「最小フロー」に、またはその反対にフローを調整するときに使用するステップ数。 |
flow-control-enabled |
flow-control-enabled |
Boolean |
接続ファクトリを使用して作成されたプロデューサでフローを制御できるかどうか。 |
one-way-send-mode |
one-way-send-mode |
String |
通常の非永続な非トランザクション・メッセージングのパフォーマンスを向上させるために、この接続ファクトリを使用して作成されたメッセージ・プロデューサに、一方向のメッセージ送信を許可するかどうか。 有効なオプションは、 |
one-way-send-window-size |
one-way-send-window-size |
integer |
One-Way Send Modeが、キュー・センダーやトピック・パブリッシャによる |
これらのプロパティの詳細は、Oracle WebLogic Server管理コンソール・オンライン・ヘルプ.のJMS接続ファクトリ: 構成: フロー制御を参照してください
表A-7 @JMSConnectionFactoryDefinitionロード・バランシング・プロパティ
@JMSConnectionFactoryDefinitionプロパティ | JMSアプリケーション・モジュールにある同等のload-balancing-params要素 | 型 | 説明 |
---|---|---|---|
load-balancing-enabled |
load-balancing-enabled |
Boolean |
接続ファクトリを介して作成された非匿名プロデューサが、分散宛先内で呼出し単位でロード・バランシングされるようにするかどうか。 |
server-affinity-enabled |
server-affinity-enabled |
Boolean |
サーバー・インスタンスで、分散宛先の複数のメンバー宛先にまたがってコンシューマまたはプロデューサのロード・バランシングを実行するときに、同じサーバー・インスタンス内で動作する他の物理宛先にまたがるロード・バランシングを最初に試行するかどうか。 |
これらのプロパティの詳細は、Oracle WebLogic Server管理コンソール・オンライン・ヘルプ.のJMS接続ファクトリの構成: ロード・バランシングを参照してください
表A-8 @JMSConnectionFactoryDefinitionロード・バランシング・プロパティ
@JMSConnectionFactoryDefinitionプロパティ | JMSアプリケーション・モジュールにある同等のsecurity-params要素 | 型 | 説明 |
---|---|---|---|
attach-jmsx-user-id |
attach-jmsx-user-id |
Boolean |
接続ファクトリを介して作成された非匿名プロデューサが、分散宛先内で呼出し単位でロード・バランシングされるようにするかどうか。 |
これらのプロパティの詳細は、Oracle WebLogic Server管理コンソール・オンライン・ヘルプのJMS接続ファクトリ: 構成: セキュリティを参照してください。
JMS宛先定義要素とプロパティ
この項では、「Java EEリソース定義を使用したJMSリソースの定義」で説明されているリソース定義の要素について説明します。
次の例は、@JMSDestinationDefinition
アノテーションを使用して宛先を定義しています。
@JMSDestinationDefinition(
name="java:global/jms/demoDestination",
interfaceName="javax.jms.Queue",
className= "javax.jms.Queue",
description="Sample description for Queue",
destinationName="myQueue",
properties= {"default-unit-of-order=true", "time-to-deliver=Persistent", "attach-sender=always"}
詳細は、アノテーション・タイプJMSDestinationDefinitionに関する項を参照してください。
JMSアプリケーション・モジュールの要素定義の詳細は、http://xmlns.oracle.com/weblogic/weblogic-jms/1.7/weblogic-jms.xsdを参照してください.
表A-9 @JMSDestinationDefinition要素
@JMSDestinationDefinition内の要素 | JMSアプリケーション・モジュールにある同等の要素 | 型 | 説明 |
---|---|---|---|
name |
jndi-name |
String |
定義されるJMS宛先リソースのJNDI名。 ノート: これは必須要素です。 |
interfaceName |
uniform-distributed-queueまたはuniform-distributed-topic。 |
String |
JMS宛先インタフェースの完全修飾名。有効なオプションは、 JMS宛先定義は、 |
description |
notes |
String |
定義されるJMS宛先の説明。 |
destination name |
name |
String |
キューまたはトピックのランタイムMBean名。指定しない場合、宛先名前は |
className |
なし |
- |
この値は無視されます。 |
resourceAdapter |
なし |
- |
この値は無視されます。 |
表A-10 @JMSDestinationDefinitionプロパティ
@JMSDestinationDefinitionプロパティ | JMSアプリケーション・モジュールにある同等の要素 | 型 | 説明 |
---|---|---|---|
jms-server-name |
sub-deployment-name |
String |
リソースに対してターゲットとして指定されるJMSサーバー。アプリケーションで指定された |
default-targeting-enabled |
default-targeting-enabled |
Boolean |
jms-server-name が指定されている場合、この値は無視されます。
|
表A-11 @JMSDestinationDefiitionしきい値プロパティ
@JMSDestinationDefinitionプロパティ | JMSアプリケーション・モジュールにある同等のthresholds要素 | 型 | 説明 |
---|---|---|---|
bytes-high |
bytes-high |
Long |
ロギングやフロー制御イベントを発生させる上限しきい値(この宛先内の合計バイト数)。 |
bytes-low |
bytes-low |
Long |
ロギングやフロー制御イベントを発生させる下限しきい値(この宛先内の合計バイト数)。 |
messages-high |
messages-high |
Long |
ロギングやフロー制御イベントを発生させる上限しきい値(この宛先内の合計メッセージ数)。 |
messages-low |
messages-low |
Long |
ロギングやフロー制御イベントを発生させる下限しきい値(この宛先内の合計メッセージ数)。 |
これらのプロパティの詳細は、Oracle WebLogic Server管理コンソール・オンライン・ヘルプの共通分散トピック: 構成: しきい値と割当て制限を参照してください。
表A-12 @JMSDestinationDefinitionメッセージ配信オーバーライド・プロパティ
@JMSDestinationDefinitionプロパティ | JMSアプリケーション・モジュールにある同等のdelivery-params-overrides 要素 | 型 | 説明 |
---|---|---|---|
delivery-mode |
delivery-mode |
String |
メッセージ・プロデューサによって指定された配信モードに関わりなく、宛先に届くすべてのメッセージに割り当てられる配信モード。 有効なオプションは、「永続」 または「非永続」です。 |
time-to-deliver |
time-to-deliver |
String |
メッセージが生成されてからそのターゲット分散宛先で表示できるようになるまでの配信遅延時間(ミリ秒単位またはスケジュールとして)。 |
time-to-live |
time-to-live |
Long |
メッセージ・プロデューサによって指定されたTimeToLive値に関係なく、宛先に届くすべてのメッセージに割り当てられる存続時間。 |
priority |
priority |
Integer |
メッセージ・プロデューサによって指定された優先度に関わりなく、宛先に届くすべてのメッセージに割り当てられる優先度。 |
redelivery-delay |
redelivery-delay |
Long |
コンシューマや接続ファクトリによって指定された再配信遅延に関わりなく、ロールバックまたは回復されたメッセージが再配信されるまでの遅延(ミリ秒単位)。 詳細は、Oracle WebLogic Server管理コンソール・オンライン・ヘルプの共通分散トピック: 構成: 再配信に関する項を参照してください。 |
これらのプロパティの詳細は、Oracle WebLogic Server管理コンソール・オンライン・ヘルプの共通分散トピック: 構成: オーバーライドに関する項を参照してください。
表A-13 @JMSDestinationDefinitionメッセージ配信障害プロパティ
@JMSDestinationDefinitionプロパティ | JMSアプリケーション・モジュールにある同等のdelivery-failure params要素 | 型 | 説明 |
---|---|---|---|
redelivery-limit |
redelivery-limit |
Integer |
メッセージがエラー宛先に移動する前に再配信を試行できる回数。 |
expiration-policy |
expiration-policy |
String |
宛先で期限切れメッセージに遭遇したときに使用するメッセージの有効期限ポリシー。 有効なオプションは、「破棄」または |
expiration-logging-policy |
expiration-logging-policy |
String |
有効期限ポリシーが |
これらのプロパティの詳細は、Oracle WebLogic Server管理コンソール・オンライン・ヘルプの共通分散トピック: 構成: 再配信を参照してください。
表A-14 @JMSDestinationDefinitionメッセージ・ロギング・プロパティ
@JMSDestinationDefinitionプロパティ | JMSアプリケーション・モジュールにある同等のmessage-logging-params 要素 | 型 | 説明 |
---|---|---|---|
message-logging-enabled |
message-logging-enabled |
Boolean |
モジュールで、メッセージのライフサイクルに関する情報をロギングするかどうか。 |
message-logging-format |
message-logging-format |
String |
メッセージに関する情報が記録されます。 このプロパティは、次の例に示すように定義されます。 このプロパティの有効値の詳細は、『Oracle WebLogic Server MBeanリファレンス』の、MessageLoggingParamsBean のMessageLoggingFormat 属性についての説明を参照してください。 |
これらのプロパティの詳細は、Oracle WebLogic Server管理コンソール・オンライン・ヘルプの共通分散宛先: 構成: ロギングを参照してください。
表A-15 @JMSDestinationDefinition詳細構成プロパティ
@JMSDestinationDefinitionプロパティ | JMSアプリケーション・モジュールにある同等の要素 | 型 | 説明 |
---|---|---|---|
load-balancing-policy |
load-balancing-policy |
String |
この宛先のメンバーにメッセージが配信される方法 有効なオプションは、「ラウンドロビン」 と「ランダム」 です |
production-paused-at-startup |
production-paused-at-startup |
Boolean |
起動時に宛先で新しいメッセージの生成を休止するかどうか |
insertion-paused-at-startup |
insertion-paused-at-startup |
Boolean |
起動時に宛先で新しいメッセージの挿入を休止するかどうか。 |
consumption-paused-at-startup |
consumption-paused-at-startup |
Boolean |
起動時に宛先で消費を休止するかどうか。 |
default-unit-of-order |
default-unit-of-order |
Boolean |
ドメイン、JMSサーバー、宛先名に基づいて、システムで生成される順序単位名をWebLogic Serverが作成するかどうかを指定します。 |
unit-of-order-routing |
unit-of-order-routing |
String |
順序単位の一部であるメッセージの宛先として分散宛先メンバーが選択される方法を指定します。 有効なオプションは、 |
attach-sender |
attach-sender |
String |
この宛先に届くメッセージに送信側ユーザーの資格証明が添付されている必要があるかどうか。有効なオプションは、「サポート」、 |
jms-create-destination-identifier |
jms-create-destination-identifier |
String |
宛先の参照名または分散宛先のメンバーの参照名。JNDIを利用せずに |
saf-export-policy |
saf-export-policy |
String |
ユーザーがストア・アンド・フォワードを使用する宛先にメッセージを送信できるかどうか。有効なオプションは、 |
messaging-performance-preferenc |
messaging-performance-preferenc |
Integer |
宛先が、コンシューマに配信する消費可能なメッセージ(存在する場合)の完全なバッチを作成するまでに待機できる期間の長さ。 |
unit-of-work-handling-policy |
unit-of-work-handling-policy |
String |
この宛先で作業単位(UOW)機能を有効化するかどうか。 有効なオプションは、 |
incomplete-work-expiration-time |
incomplete-work-expiration-time |
Integer |
未完了のUOW内の未配信メッセージが期限切れになるまでの最長時間(ミリ秒)。 |
これらのプロパティの詳細は、『Oracle WebLogic Server Administration Consoleオンライン・ヘルプ』の共通分散トピック: 構成: 一般 に関する項にある、詳細構成オプションを参照してください。
ノート:
これらのプロパティは、@JMSDestinationDefinition
のinterfaceName
要素がjavax.jms.Queue
に設定されている場合のみ適用できます。これらのプロパティの詳細は、Oracle WebLogic Server管理コンソール・オンライン・ヘルプの共通分散キュー: 構成: 全般を参照してください。
表A-16 キュー宛先のための@JMSDestinationDefinitionプロパティ
@JMSDestinationDefinitionプロパティ | JMSアプリケーション・モジュールにある同等の要素 | 型 | 説明 |
---|---|---|---|
forward-delay |
forward-delay |
Integer |
コンシューマを持たない共通分散キュー・メンバーが、コンシューマを持つ他の共通分散キュー・メンバーにメッセージを転送するまでに待機する秒数。 |
reset-delivery-count-on-forward |
reset-delivery-count-on-forward |
Boolean |
分散キュー・メンバー間でのメッセージ転送時に配信回数をリセットするかどうか。 |
ノート:
これらのプロパティは、@JMSDestinationDefinition
のinterfaceName
要素がjavax.jms.Topicに設定されている場合のみ適用できます。
これらのプロパティの詳細は、Oracle WebLogic Server管理コンソール・オンライン・ヘルプ.の共通分散トピック: 構成: 全般と、共通分散トピック: マルチキャストを参照してください
表A-17 キュー宛先のための@JMSDestinationDefinitionプロパティ
@JMSDestinationDefinitionプロパティ | JMSアプリケーション・モジュールにある同等の要素 | 型 | 説明 |
---|---|---|---|
forwarding-policy |
forwarding-policy |
String |
送信されたメッセージをすべてのメンバーに転送するかどうかを指定する共通分散トピックのメッセージ転送ポリシー。 有効なオプションは、 宛先がJMS宛先定義を使用して作成された場合、このプロパティのデフォルト値は ノート: 共通分散トピックが ノート: WebLogic Server Multitenantドメイン・パーティション、リソース・グループ、リソース・グループ・テンプレートおよび仮想ターゲットは、WebLogic Server 12.2.1.4.0で非推奨になっており、次のリリースで削除されます。 |
multicast-address |
multicast-address |
String |
トピックが、マルチキャスト・コンシューマにメッセージを送信するために使用できるアドレス。 |
multicast-time-to-live |
multicast-time-to-live |
Integer |
マルチキャストの存続時間の値。メッセージがコンシューマに到達するまでに通過できるルーターの数を指定します。 |
multicast-port |
multicast-port |
Integer |
トピックが、マルチキャスト・コンシューマにメッセージを送信するために使用されるポート。 |