Packagecom.kaazing.gateway.jms.client
Interfacepublic interface Topic extends Destination
SubinterfacesTemporaryTopic

A Topic object encapsulates a provider-specific topic name. It is the way a client specifies the identity of a topic to JMS API methods. For those methods that use a Destination as a parameter, a Topic object may used as an argument . For example, a Topic can be used to create a MessageConsumer and a MessageProducer by calling: UL> LI> Session.CreateConsumer(Destination destination) LI> Session.CreateProducer(Destination destination) /UL>

Many publish/subscribe (pub/sub) providers group topics into hierarchies and provide various options for subscribing to parts of the hierarchy. The JMS API places no restriction on what a Topic object represents. It may be a leaf in a topic hierarchy, or it may be a larger part of the hierarchy.

The organization of topics and the granularity of subscriptions to them is an important part of a pub/sub application's architecture. The JMS API does not specify a policy for how this should be done. If an application takes advantage of a provider-specific topic-grouping mechanism, it should document this. If the application is installed using a different provider, it is the job of the administrator to construct an equivalent topic architecture and create equivalent Topic objects.

See also

Session.html#createConsumer(Destination)
Session.html#createProducer(Destination)


Public Properties
 PropertyDefined by
  topicName : String
[read-only] Gets the name of this topic.
Topic
Public Methods
 MethodDefined by
  
toString():String
Returns a string representation of this object.
Topic
Property detail
topicNameproperty
topicName:String  [read-only]

Gets the name of this topic.

Clients that depend upon the name are not portable.

Implementation
    public function get topicName():String
Method detail
toString()method
public function toString():String

Returns a string representation of this object.

Returns
String — the provider-specific identity values for this topic