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