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
オブジェクトを作成するのは管理者のジョブです。
Session.createConsumer(Destination)
, Session.createProducer(Destination)
, TopicSession.createTopic(String)
修飾子と型 | メソッドと説明 |
---|---|
StringSE | getTopicName() このトピックの名前を取得します。 |
StringSE | toString() このオブジェクトの文字列表現を返します。 |
StringSE getTopicName() throws JMSException
名前に依存するクライアントは移植できません。
JMSException
- Topic
の Jakarta Messaging プロバイダー実装が、内部エラーのためにトピック名を返さない場合。StringSE toString()
ObjectSE
の toStringSE
Copyright © 2018,2020 Eclipse Foundation.
Use is subject to license terms.