パッケージ 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
関連事項:
  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    このトピックの名前を取得します。
    このオブジェクトの文字列表現を返します。
  • メソッドの詳細

    • getTopicName

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

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

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

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