パッケージ jakarta.jms

クラス TopicRequestor

java.lang.ObjectSE
jakarta.jms.TopicRequestor
public class TopicRequestor extends ObjectSE
TopicRequestor ヘルパークラスは、サービスリクエストの作成を簡素化します。

TopicRequestor コンストラクターには、トランザクションされていない TopicSession と宛先 Topic が与えられます。レスポンス用の TemporaryTopic を作成し、リクエストメッセージを送信してそのレスポンスを待機する request メソッドを提供します。

これは非常に基本的なリクエスト / 応答の抽象化であり、セッションが AUTO_ACKNOWLEDGE または DUPS_OK_ACKNOWLEDGE のいずれかの配信モードでトランザクションされていないことを前提としています。ほとんどのアプリケーションは、それほど基本的な実装を作成しないことが予想されます。

導入:
JMS 1.0
バージョン:
Jakarta Messaging 2.0
関連事項:

  • コンストラクターの詳細

    • TopicRequestor

      public TopicRequestor(TopicSession session, Topic topic) throws JMSException
      TopicRequestor クラスのコンストラクター。

      この実装では、セッションパラメーターが非トランザクションであり、配信モードが AUTO_ACKNOWLEDGE または DUPS_OK_ACKNOWLEDGE であると想定しています。

      パラメーター:
      session - トピックが属する TopicSession 
      topic - リクエスト / 応答呼び出しを実行するトピック
      例外:
      JMSException - 内部エラーが原因で Jakarta Messaging プロバイダーが TopicRequestor の作成に失敗した場合。
      InvalidDestinationException - 無効なトピックが指定された場合。

  • 方法の詳細

    • request

      public Message request(Message message) throws JMSException
      リクエストを送信し、返信を待ちます。一時的なトピックは JMSReplyTo 宛先に使用されます。最初の応答が返され、それ以降の応答はすべて破棄されます。
      パラメーター:
      message - 送信するメッセージ
      戻り値:
      返信メッセージ
      例外:
      JMSException - 内部エラーが原因で Jakarta Messaging プロバイダーがリクエストを完了できない場合。

    • close

      public void close() throws JMSException
      TopicRequestor とそのセッションを閉じます。

      プロバイダーは、Java 仮想マシンの外部で TopicRequestor に代わって一部のリソースを割り当てる可能性があるため、クライアントは、必要のないときに閉じる必要があります。最終的にこれらのリソースを再利用するためにガベージコレクションに依存することは、十分なタイムリーではない可能性があります。

      このメソッドは、TopicRequestor コンストラクターに渡された TopicSession オブジェクトを閉じることに注意してください。

      例外:
      JMSException - 内部エラーが原因で Jakarta Messaging プロバイダーが TopicRequestor を閉じることができない場合。