Java EE 5 SDK

javax.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.

Version:
1.1 - February 2, 2002
Author:
Mark Hapner, Rich Burridge, Kate Stout
See Also:
Session.createTemporaryTopic(), TopicSession.createTemporaryTopic()

Method Summary
 void delete()
          Deletes this temporary topic.
 
Methods inherited from interface javax.jms.Topic
getTopicName, toString
 

Method Detail

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 JMS provider fails to delete the temporary topic due to some internal error.

Java EE 5 SDK

Submit a bug or feature

Copyright 2006 Sun Microsystems, Inc. All rights reserved.