javax.jms

Interface Topic

Contents
  • All Superinterfaces:
    Destination
    All Known Subinterfaces:
    TemporaryTopic

    public interface Topic
extends Destination
    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.

    Since:
    JMS 1.0
    Version:
    JMS 2.0
    See Also:
    Session.createConsumer(Destination), Session.createProducer(Destination), TopicSession.createTopic(String)

    • Method Detail

      • getTopicName

        String getTopicName()
             throws JMSException
        Gets the name of this topic.

        Clients that depend upon the name are not portable.

        Returns:
        the topic name
        Throws:
        JMSException - if the JMS provider implementation of Topic fails to return the topic name due to some internal error.

      • toString

        String toString()
        Returns a string representation of this object.
        Overrides:
        toString in class Object
        Returns:
        the provider-specific identity values for this topic

Document created the 11/06/2005, last modified the 18/08/2025
Source of the printed document:https://www.gaudry.be/en/java-api-javaee-rf-javax/jms/Topic.html

The infobrol is a personal site whose content is my sole responsibility. The text is available under CreativeCommons license (BY-NC-SA). More info on the terms of use and the author.

References

  1. View the html document Language of the document:fr Manuel PHP : https://docs.oracle.com, Topic (Java(TM) EE 7 Specification APIs)

These references and links indicate documents consulted during the writing of this page, or which may provide additional information, but the authors of these sources can not be held responsible for the content of this page.
The author of this site is solely responsible for the way in which the various concepts, and the freedoms that are taken with the reference works, are presented here. Remember that you must cross multiple source information to reduce the risk of errors.