com.solacesystems.jms

Class SolQueueSender

java.lang.Object

com.solacesystems.jms.SolMessageProducer

com.solacesystems.jms.SolQueueSender

All Implemented Interfaces:

SolCloseableIF, SolMessageProducerIF, SolProducerEventSource, MessageProducer, QueueSender

public class SolQueueSender
extends SolMessageProducer
implements QueueSender

Field Summary

Fields inherited from class com.solacesystems.jms.SolMessageProducer

Encoder

Method Summary

Modifier and Type	Method and Description
Queue	getQueue() Gets the queue associated with this QueueSender.
void	send(Message message) Sends a message using the MessageProducer's default delivery mode, priority, and time to live.
void	send(Message message, int deliveryMode, int priority, long timeToLive) Sends a message to the destination, specifying delivery mode, priority, and time to live.
void	send(Queue queue, Message message) Sends a message to a queue for an unidentified message producer.
void	send(Queue queue, Message message, int deliveryMode, int priority, long timeToLive) Sends a message to a queue for an unidentified message producer, specifying delivery mode, priority and time to live.

Methods inherited from class com.solacesystems.jms.SolMessageProducer

cancel, close, deliverToOne, getDeliveryMode, getDestination, getDisableMessageID, getDisableMessageTimestamp, getPriority, getTimeToLive, isDMQEligible, isElidingEligible, isReplyMessage, isXMLPayload, send, send, setDeliveryMode, setDisableMessageID, setDisableMessageTimestamp, setPriority, setProducerEventListener, setTimeToLive, useDirectMessaging

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface javax.jms.MessageProducer

close, getDeliveryMode, getDestination, getDisableMessageID, getDisableMessageTimestamp, getPriority, getTimeToLive, send, send, setDeliveryMode, setDisableMessageID, setDisableMessageTimestamp, setPriority, setTimeToLive

Method Detail

getQueue

public Queue getQueue()
               throws JMSException

Description copied from interface: QueueSender

Gets the queue associated with this QueueSender.

Specified by:

getQueue in interface QueueSender

Returns:

this sender's queue

Throws:

JMSException - if the JMS provider fails to get the queue for this QueueSender due to some internal error.

send

public void send(Message message)
          throws JMSException

Description copied from interface: MessageProducer

Sends a message using the MessageProducer's default delivery mode, priority, and time to live.

When sending non-persistent messages, notifications of quota, permission, or endpoint problems will occur by sending an exception asynchronously through the Connection's ExceptionListener. In this case the send API will return without error but the message will not have been accepted. When sending persistent messages, the send API will always throw an exception when messages are not accepted.

Specified by:

send in interface MessageProducer

Specified by:

send in interface QueueSender

Overrides:

send in class SolMessageProducer

Parameters:

message - the message to send

Throws:

JMSException - if the JMS provider fails to send the message due to some internal error.

MessageFormatException - if an invalid message is specified.

InvalidDestinationException - if a client uses this method with a MessageProducer with an invalid destination.

See Also:

Session.createProducer(javax.jms.Destination), MessageProducer

send

public void send(Message message,
                 int deliveryMode,
                 int priority,
                 long timeToLive)
          throws JMSException

Description copied from interface: MessageProducer

Sends a message to the destination, specifying delivery mode, priority, and time to live.

When sending non-persistent messages, notifications of quota, permission, or endpoint problems will occur by sending an exception asynchronously through the Connection's ExceptionListener. In this case the send API will return without error but the message will not have been accepted. When sending persistent messages, the send API will always throw an exception when messages are not accepted.

Specified by:

send in interface MessageProducer

Specified by:

send in interface QueueSender

Overrides:

send in class SolMessageProducer

Parameters:

message - the message to send

deliveryMode - the delivery mode to use

priority - the priority for this message

timeToLive - the message's lifetime (in milliseconds) Supported since 4.6.1 SolOS-TR.

Throws:

JMSException - if the JMS provider fails to send the message due to some internal error.

MessageFormatException - if an invalid message is specified.

InvalidDestinationException - if a client uses this method with a MessageProducer with an invalid destination.

See Also:

Session.createProducer(javax.jms.Destination)

send

public void send(Queue queue,
                 Message message)
          throws JMSException

Description copied from interface: QueueSender

Sends a message to a queue for an unidentified message producer. Uses the QueueSender's default delivery mode, priority, and time to live.

Typically, a message producer is assigned a queue at creation time; however, the JMS API also supports unidentified message producers, which require that the queue be supplied every time a message is sent.

When sending non-persistent messages, notifications of quota, permission, or endpoint problems will occur by sending an exception asynchronously through the Connection's ExceptionListener. In this case the send API will return without error but the message will not have been accepted. When sending persistent messages, the send API will always throw an exception when messages are not accepted.

Specified by:

send in interface QueueSender

Parameters:

queue - the queue to send this message to

message - the message to send

Throws:

JMSException - if the JMS provider fails to send the message due to some internal error.

MessageFormatException - if an invalid message is specified.

InvalidDestinationException - if a client uses this method with an invalid queue.

See Also:

MessageProducer.getDeliveryMode(), MessageProducer.getTimeToLive(), MessageProducer.getPriority()

send

public void send(Queue queue,
                 Message message,
                 int deliveryMode,
                 int priority,
                 long timeToLive)
          throws JMSException

Description copied from interface: QueueSender

Sends a message to a queue for an unidentified message producer, specifying delivery mode, priority and time to live.

Typically, a message producer is assigned a queue at creation time; however, the JMS API also supports unidentified message producers, which require that the queue be supplied every time a message is sent.

When sending non-persistent messages, notifications of quota, permission, or endpoint problems will occur by sending an exception asynchronously through the Connection's ExceptionListener. In this case the send API will return without error but the message will not have been accepted. When sending persistent messages, the send API will always throw an exception when messages are not accepted.

Specified by:

send in interface QueueSender

Parameters:

queue - the queue to send this message to

message - the message to send

deliveryMode - the delivery mode to use

priority - the priority for this message

timeToLive - the message's lifetime (in milliseconds) Supported since 4.6.1 SolOS-TR.

Throws:

JMSException - if the JMS provider fails to send the message due to some internal error.

MessageFormatException - if an invalid message is specified.

InvalidDestinationException - if a client uses this method with an invalid queue.