Module jakarta.messaging

Package jakarta.jms

Interface TemporaryTopic

All Superinterfaces:

Destination, Topic

public interface TemporaryTopic
extends Topic

A TemporaryTopic object is a unique Topic object created for the duration of a Connection. It is a system-defined topic that can be consumed only by the Connection that created it.

A TemporaryTopic object can be created either at the Session or TopicSession level. Creating it at the Session level allows the TemporaryTopic to participate in the same transaction with objects from the PTP domain. If a TemporaryTopic is created at the TopicSession, it will only be able participate in transactions with objects from the Pub/Sub domain.

Since:

JMS 1.0

Version:

Jakarta Messaging 2.0

See Also:

• Session.createTemporaryTopic()
• TopicSession.createTemporaryTopic()

Method Summary

Modifier and Type	Method	Description
void	delete()	Deletes this temporary topic.

Methods inherited from interface jakarta.jms.Topic

getTopicName, toString

Method Details

delete

void delete()
     throws JMSException

Deletes this temporary topic. If there are existing subscribers still using it, a JMSException will be thrown.

Throws:

JMSException - if the Jakarta Messaging provider fails to delete the temporary topic due to some internal error.