javax.jms.TemporaryTopic Maven / Gradle / Ivy
/*
* @(#)TemporaryTopic.java 1.11 02/04/09
*
* Copyright 1997-2002 Sun Microsystems, Inc. All Rights Reserved.
*
* SUN PROPRIETARY/CONFIDENTIAL.
* This software is the proprietary information of Sun Microsystems, Inc.
* Use is subject to license terms.
*
*/
package javax.jms;
/** 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
* @author Rich Burridge
* @author Kate Stout
*
* @see Session#createTemporaryTopic()
* @see TopicSession#createTemporaryTopic()
*/
public interface TemporaryTopic extends Topic {
/** Deletes this temporary topic. If there are existing subscribers
* still using it, a JMSException will be thrown.
*
* @exception JMSException if the JMS provider fails to delete the
* temporary topic due to some internal error.
*/
void
delete() throws JMSException;
}