com.sssw.jms.api
Class JMQQueue

java.lang.Object
  org.omg.CORBA.portable.ObjectImpl
      com.sssw.jbroker.orb.ValueWrapper
          com.sssw.jms.api.JMQAdministeredObject
              com.sssw.jms.api.JMQDestination
                  com.sssw.jms.api.JMQQueue

All Implemented Interfaces:

Destination, Object, Queue, Referenceable, Serializable

public class JMQQueue

extends JMQDestination

implements Queue

A Novell exteNd Messaging Platform JMS queue object encapsulates a queue name. It is the way a client specifies the identity of queues to JMS methods.

See Also:

JMQDestination, Serialized Form

Field Summary

Fields inherited from class com.sssw.jms.api.JMQDestination

QUEUE, TOPIC

Method Summary

String	getBrokerName() Get the broker name serving this Queue.
static JMQQueue	getQueue(String queueName) Construct a Novell exteNd Messaging Platform JMS queue object with a given name.
static JMQQueue	getQueue(String queueName, String brokerName) Construct a Novell exteNd Messaging Platform JMS queue object with a given name, which is bound to a particular broker in a cluster.
String	getQueueName() Get the name of this Queue.
Reference	getReference() Get a JNDI reference for this queue.
void	setBrokerName(String brokerName) Set the broker name where this Queue resides.
void	setQueueName(String queueName) Set the name of this Queue.
String	toString() Return a pretty printed version of the queue name.

Methods inherited from class com.sssw.jms.api.JMQDestination

getName, getType, toNative

Methods inherited from class com.sssw.jbroker.orb.ValueWrapper

_ids

Methods inherited from class org.omg.CORBA.portable.ObjectImpl

_create_request, _create_request, _duplicate, _get_delegate, _get_domain_managers, _get_interface_def, _get_policy, _hash, _invoke, _is_a, _is_equivalent, _is_local, _non_existent, _orb, _release, _releaseReply, _request, _request, _servant_postinvoke, _servant_preinvoke, _set_delegate, _set_policy_override, equals, hashCode

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Method Detail

getQueue

public static final JMQQueue getQueue(String queueName)

Construct a Novell exteNd Messaging Platform JMS queue object with a given name.

The constructed object is a handle to the queue with the given name running inside the Novell exteNd Messaging Platform JMS server.

Note that the preferred/portable way to get queue objects is via JNDI.

Parameters:

queueName - The queue name.

Returns:

A JMQQueue object.

getQueue

public static final JMQQueue getQueue(String queueName,
                                      String brokerName)

Construct a Novell exteNd Messaging Platform JMS queue object with a given name, which is bound to a particular broker in a cluster.

The constructed object is a handle to the queue with the given name running inside the Novell exteNd Messaging Platform JMS server.

Note that the preferred/portable way to get queue objects is via JNDI.

Parameters:

queueName - The queue name.

brokerName - The broker name where queue resides.

Returns:

A JMQQueue object.

Since:

jBroker MQ 2.0

toString

public String toString()

Return a pretty printed version of the queue name.

Specified by:

toString in interface Queue

Overrides:

toString in class ObjectImpl

Returns:

The provider specific identity values for this queue.

setQueueName

public void setQueueName(String queueName)

Set the name of this Queue.

Parameters:

queueName - the name of queue

getQueueName

public String getQueueName()
                    throws JMSException

Get the name of this Queue.

Specified by:

getQueueName in interface Queue

Returns:

the name of queue

Throws:

JMSException - not raised by this implementation

setBrokerName

public void setBrokerName(String brokerName)

Set the broker name where this Queue resides.

Parameters:

brokerName - name of broker were Queue resides

Since:

jBroker MQ 2.0

getBrokerName

public String getBrokerName()

Get the broker name serving this Queue.

Returns:

the broker name where queue resides

Since:

jBroker MQ 2.0

getReference

public Reference getReference()
                       throws NamingException

Get a JNDI reference for this queue. This allows for storing Novell exteNd Messaging Platform JMS queue in all JNDI naming contexts.

Specified by:

getReference in interface Referenceable

Returns:

a reference to the queue object

Throws:

NamingException - if the JNDI reference could not be created