パッケージ 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
    関連事項:
    QueueRequestor

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

      • 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 を閉じることができない場合。