javax.jms
Interface Queue

All Superinterfaces:
Destination
All Known Subinterfaces:
TemporaryQueue

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.

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

getQueueName

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

Clients that depend upon the name are not portable.

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

toString

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

Overrides:
toString in class java.lang.Object
Returns:
the provider-specific identity values for this queue


Submit a bug or feature

Copyright © 2009-2011, Oracle Corporation and/or its affiliates. All Rights Reserved. Use is subject to license terms.

Generated on 10-February-2011 12:41