TemporaryTopic (Java 2 Platform Ent. Ed. v1.4) - Java Platform, Enterprise Edition v1.4 API Specifications

Overview

Package

Class

Tree

Deprecated

Index

Help

Java^TM 2 Platform
Ent. Ed. v1.4

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

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

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