- /*
- * Copyright 2002 Sun Microsystems, Inc. All rights reserved.
- * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
- */
-
- package javax.jms;
-
-
- /** A <CODE>Topic</CODE> object encapsulates a provider-specific topic name.
- * It is the way a client specifies the identity of a topic to JMS API methods.
- *
- * <P>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 <CODE>Topic</CODE> object
- * represents. It may be a leaf in a topic hierarchy, or it may be a larger
- * part of the hierarchy.
- *
- * <P>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 <CODE>Topic</CODE> objects.
- *
- * @version 1.0 - 13 March 1998
- * @author Mark Hapner
- * @author Rich Burridge
- *
- * @see javax.jms.TopicSession#createTopic(String)
- */
-
- public interface Topic extends Destination {
-
- /** Gets the name of this topic.
- *
- * <P>Clients that depend upon the name are not portable.
- *
- * @return the topic name
- *
- * @exception JMSException if the JMS provider implementation of
- * <CODE>Topic</CODE> fails to return the topic
- * name due to some internal
- * error.
- */
-
- String
- getTopicName() throws JMSException;
-
-
- /** Returns a string representation of this object.
- *
- * @return the provider-specific identity values for this topic
- */
-
- String
- toString();
- }