パッケージ 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)
メソッドのサマリー
すべてのメソッド インスタンスメソッド 抽象メソッド 修飾子と型 メソッド 説明 StringSE
getTopicName()
このトピックの名前を取得します。StringSE
toString()
このオブジェクトの文字列表現を返します。
メソッドの詳細
getTopicName
StringSE getTopicName() throws JMSException
このトピックの名前を取得します。名前に依存するクライアントは移植できません。
- 戻り値:
- トピック名
- 例外:
JMSException
-Topic
の Jakarta Messaging プロバイダー実装が、内部エラーのためにトピック名を返さない場合。