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:/[queue|topic]?<property>=<value>&<property>=<value>&...
URL の構成は、トランスポート・タイプ jms: の後に、
JMS 宛先タイプを表す /queue または /topic が続き、さらにその後に、
JMS エンドポイント情報の指定に使用するプロパティーと値のペアのリストを含む照会ストリングが続くというものです。sptcfg次の表では、URL ストリングでサポートされるプロパティーについて説明しています。
プロパティー名 | 説明 |
---|---|
destination | 宛先のキューまたはトピックの Java Naming and Directory Interface (JNDI) 名 を指定します。 |
connectionFactory | 接続ファクトリーの JNDI 名を指定します。 |
targetService | 要求のディスパッチ先であるポート・コンポーネントの名前を指定します。 |
プロパティー名 | 説明 |
---|---|
initialContextFactory | java.naming.factory.initial プロパティーにマップされる、 使用する初期コンテキスト・ファクトリーの名前を指定します。 |
jndiProviderURL | java.naming.provider.url プロパティーにマップされる、 JNDI プロバイダーの URL を指定します。 |
プロパティー名 | 説明 |
---|---|
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 ストリングの一部として指定されたプロパティーよりも優先されます。