java.lang.Object
org.activemq.jndi.JNDIBaseStorable
org.activemq.message.ActiveMQDestination
org.activemq.message.ActiveMQTopic
- All Implemented Interfaces:
- java.lang.Comparable, javax.jms.Destination, org.activemq.jndi.JNDIStorableInterface, javax.naming.Referenceable, java.io.Serializable, javax.jms.Topic
- Direct Known Subclasses:
- ActiveMQTemporaryTopic
- public class ActiveMQTopic
- extends ActiveMQDestination
- implements javax.jms.Topic
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:
-
Session.CreateConsumer(Destination destination)
-
Session.CreateProducer(Destination destination)
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.
| Methods inherited from class org.activemq.message.ActiveMQDestination |
buildFromProperties, compareTo, compareTo, createDestination, createTemporaryName, decrementConsumerCounter, delete, equals, getChildDestinations, getClientId, getDestinationBeingAdvised, getDestinationFilter, getDestinationPaths, getOrderedTarget, getPhysicalName, getSessionCreatedBy, getStats, getTopicForConsumerAdvisory, getTopicForProducerAdvisory, getTopicForTempAdvisory, hashCode, incrementConsumerCounter, inspect, isAdvisory, isComposite, isConnectionAdvisory, isConsumerAdvisory, isDeleted, isExclusive, isOrdered, isProducerAdvisory, isQueue, isTempDestinationAdvisory, isTemporary, isTopic, isWildcard, matches, populateProperties, readFromStream, setAdvisory, setChildDestinations, setDeleted, setExclusive, setOrdered, setOrderedTarget, setPhysicalName, setSessionCreatedBy, setStats, toString, transformDestination, writeToStream |
serialVersionUID
private static final long serialVersionUID
- See Also:
- Constant Field Values
ActiveMQTopic
public ActiveMQTopic()
- Default constructor for an ActiveMQTopic Destination
ActiveMQTopic
public ActiveMQTopic(java.lang.String name)
- Construct a named ActiveMQTopic Destination
getTopicName
public java.lang.String getTopicName()
- Gets the name of this Topic.
Clients that depend upon the name are not portable.
- Specified by:
getTopicName in interface javax.jms.Topic
getDestinationType
public int getDestinationType()
- Specified by:
getDestinationType in class ActiveMQDestination
createDestination
protected javax.jms.Destination createDestination(java.lang.String name)
- Description copied from class:
ActiveMQDestination
- Factory method to create a child destination if this destination is a composite
- Specified by:
createDestination in class ActiveMQDestination
createDestinationStats
protected org.activemq.management.JMSDestinationStats createDestinationStats()
- Description copied from class:
ActiveMQDestination
- Factory method to create a statistics counter object
- Specified by:
createDestinationStats in class ActiveMQDestination