Message Queue, v4.4 API Specification

## javax.jms
Interface Queue

All Superinterfaces:
  Destination

All Known Subinterfaces:
  TemporaryQueue

All Known Implementing Classes:
  BasicQueue, Queue

    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:

- `Session.CreateConsumer(Destination destination)`
- `Session.CreateProducer(Destination destination)`

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

Message Queue, v4.4 API Specification

Copyright 2009 Sun Microsystems, Inc.
4150 Network Circle, Santa Clara, CA 95054, U.S.A. All Rights Reserved.