パッケージ jakarta.jms

インターフェース Topic

  • すべてのスーパーインターフェース:
    Destination
    すべての既知のサブインターフェース:
    TemporaryTopic

    public interface Topic
    extends Destination
    Topic オブジェクトは、プロバイダー固有のトピック名をカプセル化します。

    これは、クライアントが Jakarta Messaging API メソッドに対してトピックの ID を指定する方法です。Destination をパラメーターとして使用するメソッドの場合、Topic オブジェクトを引数として使用できます。例: トピックを使用して、以下を呼び出すことにより、MessageConsumer および MessageProducer を作成できます。

    • Session.CreateConsumer(Destination destination)
    • Session.CreateProducer(Destination destination)

    多くのパブリッシュ / サブスクライブ(pub/sub)プロバイダーは、トピックを階層にグループ化し、階層の一部をサブスクライブするためのさまざまなオプションを提供します。Jakarta Messaging API は、Topic オブジェクトが表すものに制限を設けていません。トピック階層のリーフの場合もあれば、階層の大部分の場合もあります。

    トピックの編成とそれらへのサブスクリプションの粒度は、pub/ サブアプリケーションのアーキテクチャの重要な部分です。Jakarta Messaging API は、これをどのように行うかについてのポリシーを指定していません。アプリケーションがプロバイダー固有のトピックグループ化メカニズムを利用する場合は、これをドキュメント化する必要があります。アプリケーションが別のプロバイダーを使用してインストールされている場合、同等のトピックアーキテクチャを構築し、同等の Topic オブジェクトを作成するのは管理者のジョブです。

    導入:
    JMS 1.0
    バージョン:
    Jakarta Messaging 2.0
    関連事項:
    Session.createConsumer(Destination), Session.createProducer(Destination), TopicSession.createTopic(String)
    • メソッドの詳細

      • getTopicName

        StringSE getTopicName()
                     throws JMSException
        このトピックの名前を取得します。

        名前に依存するクライアントは移植できません。

        戻り値:
        トピック名
        例外:
        JMSException - Topic の Jakarta Messaging プロバイダー実装が、内部エラーのためにトピック名を返さない場合。
      • toString

        StringSE toString()
        このオブジェクトの文字列表現を返します。
        オーバーライド:
        クラス ObjectSEtoString 
        戻り値:
        このトピックのプロバイダー固有の ID 値