SunONE Application Server v8.0 PE

Interface Queue

All Superinterfaces:
All Known Subinterfaces:

public interface Queue
extends Destination

A Queue object encapsulates a provider-specific queue name. It is the way a client specifies the identity of a queue to JMS API methods. For those methods that use a Destination as a parameter, a Queue object used as an argument. For example, a queue can be used to create a MessageConsumer and a MessageProducer by calling:

The actual length of time messages are held by a queue and the consequences of resource overflow are not defined by the JMS API.

1.1 February 2 - 2000
Mark Hapner, Rich Burridge, Kate Stout
See Also:
Session.createConsumer(Destination), Session.createProducer(Destination), Session.createQueue(String), QueueSession.createQueue(String)

Method Summary
 java.lang.String getQueueName()
          Gets the name of this queue.
 java.lang.String toString()
          Returns a string representation of this object.

Method Detail


public java.lang.String getQueueName()
                              throws JMSException
Gets the name of this queue.

Clients that depend upon the name are not portable.

the queue name
JMSException - if the JMS provider implementation of Queue fails to return the queue name due to some internal error.


public java.lang.String toString()
Returns a string representation of this object.

the provider-specific identity values for this queue

SunONE Application Server v8.0 PE

Submit a bug or feature

Copyright 2003 Sun Microsystems, Inc. All rights reserved.