IBM 所有の JMS エンドポイント URL の構文 (非推奨)

Java™ Message Service (JMS) エンドポイント URL は、Java API for XML Web Services (JAX-WS) または Java API for XML-based RPC (JAX-RPC) Web サービスに JMS トランスポートでアクセスするために使用されます。この専有 URL には、Java Message Service (JMS) の宛先と接続ファクトリー、および Web サービス要求のポート・コンポーネント名が指定されます。これは、 ホストとポートに加えてコンテキスト・ルートとポート・コンポーネント名も指定する HTTP エンドポイント URL に似ています。

サポートされる構成 サポートされる構成: JMS エンドポイント URL の一般的な形式は、次のとおりです。
jms:/[queue|topic]?<property>=<value>&<property>=<value>&...
URL の構成は、トランスポート・タイプ jms: の後に、 JMS 宛先タイプを表す /queue または /topic が続き、さらにその後に、 JMS エンドポイント情報の指定に使用するプロパティーと値のペアのリストを含む照会ストリングが続くというものです。sptcfg

次の表では、URL ストリングでサポートされるプロパティーについて説明しています。

表 1. 宛先関連のプロパティー (必須). これらのプロパティーを使用して、JMS エンドポイント URL の宛先関連のプロパティーを指定します。
プロパティー名 説明
destination 宛先のキューまたはトピックの Java Naming and Directory Interface (JNDI) 名 を指定します。
connectionFactory 接続ファクトリーの JNDI 名を指定します。
targetService 要求のディスパッチ先であるポート・コンポーネントの名前を指定します。
表 2. JNDI 関連のプロパティー (オプション). これらのプロパティーを使用して、JMS エンドポイント URL の JNDI 関連のプロパティーを指定します。
プロパティー名 説明
initialContextFactory java.naming.factory.initial プロパティーにマップされる、 使用する初期コンテキスト・ファクトリーの名前を指定します。
jndiProviderURL java.naming.provider.url プロパティーにマップされる、 JNDI プロバイダーの URL を指定します。
表 3. JMS 関連のプロパティー (オプション). これらのプロパティーを使用して、JMS エンドポイント URL の JMS 関連のプロパティーを指定します。
プロパティー名 説明
deliveryMode 要求メッセージをパーシスタントにするかどうかを指定します。 有効な値は 1 (非永続) および 2 (永続) です。 デフォルト値は 1 です。
timeToLive JMS 要求メッセージの存続時間をミリ秒単位で指定します。 デフォルト値の 0 は、存続時間が無制限になることを表します。 ただし、Web サービスを使用している場合、このプロパティーは、synchTimeout プロパティーに指定された値で制限されます。 synchTimeout プロパティーの設定により、クライアントがサーバーからの応答を待つ時間が決定します。 この制限 は、クライアントがサーバーからの応答を待機するのを停止した後も JMS メッセージがアクティブのままになるのを防止します。
priority 要求メッセージに関連付けられる JMS 優先順位を指定します。 有効な値は 0 から 9 までの間です。デフォルト値は 4 です。 値 0 は優先順位が最も低く、値 9 は優先順位が最も高くなります。
replyToDestination 応答メッセージの受信に使用される、キューの JNDI 名を指定します。 このオプションのプロパティーを使用すると、クライアントは、応答を受信するのに、一時キューではなく永続キューを使用できるようになります。

JMS 要求上で deliveryMode、timeToLive、および priority プロパティーの値を 設定した場合、その値は、JMS 要求メッセージから 対応する JMS 応答メッセージに伝搬されます。

必須プロパティーである destination、connectionFactory、および targetService は、 JMS エンドポイント URL ストリングに含まれている必要があります。 それ以外のプロパティーは、 オプションです。

任意のプロパティーをクライアントの Stub オブジェクトに設定できます。 さまざまなプロパティーを、エンドポイント URL の一部として組み込むことにより指定したり、 クライアントの Stub オブジェクトでプログラマチックに設定したりすることができます。 クライアントの Stub オブジェクトで指定されたプロパティーは、 JMS エンドポイント URL ストリングの一部として指定されたプロパティーよりも優先されます。


トピックのタイプを示すアイコン 参照トピック



タイム・スタンプ・アイコン 最終更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rwbs_jmsurl
ファイル名:rwbs_jmsurl.html