Java EE 5 SDK

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
 String getQueueName()
          Gets the name of this queue.
 String toString()
          Returns a string representation of this object.

Method Detail


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.


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

toString in class Object
the provider-specific identity values for this queue

Java EE 5 SDK

Submit a bug or feature

Copyright 2007 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.

Scripting on this page tracks web page traffic, but does not change the content in any way.