パッケージ jakarta.jms
インターフェース QueueSession
- すべてのスーパーインターフェース:
AutoCloseableSE、RunnableSE、Session
QueueSession オブジェクトは、QueueReceiver、QueueSender、QueueBrowser、TemporaryQueue オブジェクトを作成するためのメソッドを提供します。QueueSession の終了時に受信されましたが確認応答されていないメッセージがある場合、これらのメッセージは保持され、コンシューマーが次にキューにアクセスしたときに再配信されます。
QueueSession は、ポイントツーポイント固有のオブジェクトを作成するために使用されます。通常は、Session オブジェクトを使用します。QueueSession は、既存のコードをサポートするために使用されます。Session オブジェクトを使用すると、プログラミングモデルが簡素化され、2 つのメッセージングドメインでトランザクションを使用できるようになります。
QueueSession を使用して、パブリッシュ / サブスクライブドメインに固有のオブジェクトを作成することはできません。次のメソッドは Session から継承しますが、QueueSession から使用する場合は IllegalStateException をスローする必要があります。
createDurableSubscribercreateDurableConsumercreateSharedConsumercreateSharedDurableConsumercreateTemporaryTopiccreateTopicunsubscribe
- 導入:
- JMS 1.0
- バージョン:
- Jakarta Messaging 2.0
- 関連事項:
フィールドのサマリー
インターフェース jakarta.jms.Session から継承されたフィールド
AUTO_ACKNOWLEDGE, CLIENT_ACKNOWLEDGE, DUPS_OK_ACKNOWLEDGE, SESSION_TRANSACTEDメソッドのサマリー
修飾子と型メソッド説明createBrowser(Queue queue) QueueBrowserオブジェクトを作成して、指定されたキューのメッセージを確認します。createBrowser(Queue queue, StringSE messageSelector) QueueBrowserオブジェクトを作成して、メッセージセレクターを使用して、指定されたキューのメッセージを確認します。createQueue(StringSE queueName) Queue名を指定してキュー ID を作成します。createReceiver(Queue queue) 指定されたキューからメッセージを受信するQueueReceiverオブジェクトを作成します。createReceiver(Queue queue, StringSE messageSelector) メッセージセレクターを使用して、指定されたキューからメッセージを受信するQueueReceiverオブジェクトを作成します。createSender(Queue queue) 指定されたキューにメッセージを送信するQueueSenderオブジェクトを作成します。TemporaryQueueオブジェクトを作成します。インターフェース jakarta.jms.Session から継承されたメソッド
close, commit, createBytesMessage, createConsumer, createConsumer, createConsumer, createDurableConsumer, createDurableConsumer, createDurableSubscriber, createDurableSubscriber, createMapMessage, createMessage, createObjectMessage, createObjectMessage, createProducer, createSharedConsumer, createSharedConsumer, createSharedDurableConsumer, createSharedDurableConsumer, createStreamMessage, createTemporaryTopic, createTextMessage, createTextMessage, createTopic, getAcknowledgeMode, getMessageListener, getTransacted, recover, rollback, run, setMessageListener, unsubscribe
メソッドの詳細
createQueue
Queue名を指定してキュー ID を作成します。この機能は、クライアントがキュー ID を動的に操作する必要があるまれなケースのために提供されています。プロバイダー固有の名前でキュー ID を作成できます。この機能に依存するクライアントは移植できません。
このメソッドは物理的なキューを作成するためのものではないことに注意してください。キューの物理的な作成は管理タスクであり、Jakarta Messaging API によって開始されません。1 つの例外は一時的なキューの作成で、これは
createTemporaryQueueメソッドで実行されます。- 次で指定:
- インターフェース
SessionのcreateQueue - パラメーター:
queueName- このQueueの名前- 戻り値:
- 指定された名前の
Queue - 例外:
JMSException- 内部エラーのためにセッションがキューの作成に失敗した場合。
createReceiver
指定されたキューからメッセージを受信するQueueReceiverオブジェクトを作成します。- パラメーター:
queue- アクセスするQueue- 戻り値:
- 指定されたキューからメッセージを受信する
QueueReceiverオブジェクト - 例外:
JMSException- 内部エラーのためにセッションがレシーバーの作成に失敗した場合。InvalidDestinationException- 無効なキューが指定された場合。
createReceiver
メッセージセレクターを使用して、指定されたキューからメッセージを受信するQueueReceiverオブジェクトを作成します。- パラメーター:
queue- アクセスするQueuemessageSelector- メッセージセレクター式に一致するプロパティを持つメッセージのみが配信されます。null または空の文字列の値は、メッセージコンシューマーにメッセージセレクタがないことを示します。- 戻り値:
- 指定されたキューからメッセージを受信する
QueueReceiverオブジェクト - 例外:
JMSException- 内部エラーのためにセッションがレシーバーの作成に失敗した場合。InvalidDestinationException- 無効なキューが指定された場合。InvalidSelectorException- メッセージセレクタが無効な場合。
createSender
指定されたキューにメッセージを送信するQueueSenderオブジェクトを作成します。- パラメーター:
queue- アクセスするQueue。これが不明なプロデューサーの場合は null- 戻り値:
- 指定されたキューにメッセージを送信するための
QueueSenderオブジェクト。 - 例外:
JMSException- 内部エラーのためにセッションが送信者の作成に失敗した場合。InvalidDestinationException- 無効なキューが指定された場合。
createBrowser
QueueBrowserオブジェクトを作成して、指定されたキューのメッセージを確認します。- 次で指定:
- インターフェース
SessionのcreateBrowser - パラメーター:
queue- アクセスするQueue- 戻り値:
- メッセージをのぞく
QueueBrowserオブジェクト。 - 例外:
JMSException- 内部エラーのためにセッションがブラウザーの作成に失敗した場合。InvalidDestinationException- 無効なキューが指定された場合。
createBrowser
QueueBrowserオブジェクトを作成して、メッセージセレクターを使用して、指定されたキューのメッセージを確認します。- 次で指定:
- インターフェース
SessionのcreateBrowser - パラメーター:
queue- アクセスするQueuemessageSelector- メッセージセレクター式に一致するプロパティを持つメッセージのみが配信されます。null または空の文字列の値は、メッセージコンシューマーにメッセージセレクタがないことを示します。- 戻り値:
- 指定されたキューのメッセージをのぞく
QueueBrowserオブジェクト。 - 例外:
JMSException- 内部エラーのためにセッションがブラウザーの作成に失敗した場合。InvalidDestinationException- 無効なキューが指定された場合。InvalidSelectorException- メッセージセレクタが無効な場合。
createTemporaryQueue
TemporaryQueueオブジェクトを作成します。それが以前に削除されない限り、その存続期間はQueueConnectionの存続期間になります。- 次で指定:
- インターフェース
SessionのcreateTemporaryQueue - 戻り値:
- 一時的なキュー ID
- 例外:
JMSException- 内部エラーのためにセッションが一時キューの作成に失敗した場合。