Spec-Zone .ru спецификации, руководства, описания, API

javax.jms
Интерфейс QueueSender

Все Суперинтерфейсы:

MessageProducer

public interface QueueSender
расширяет MessageProducer

Клиент использует a QueueSender объект отправить сообщения очереди.

Обычно, Queue определяется когда a QueueSender создается. В этом случае, попытка использовать send методы для неопознанного QueueSender бросит a java.lang.UnsupportedOperationException.

Если QueueSender создается с неопознанным Queue, попытка использовать send методы, которые предполагают что Queue был идентифицирован бросит a java.lang.UnsupportedOperationException.

Во время выполнения send метод, сообщение не должно быть изменено другими потоками в пределах клиента. Если сообщение изменяется, результат send неопределено.

После отправки сообщения клиент может сохранить и изменить это, не влияя на сообщение, которое было отправлено. Тот же самый объект сообщения может быть отправлен многократно.

Следующие заголовки сообщения устанавливаются как часть отправки сообщения: JMSDestination, JMSDeliveryMode, JMSExpiration, JMSPriority, JMSMessageID и JMSTimeStamp. Когда сообщение отправляется, значения этих заголовков игнорируются. После завершения send, заголовки содержат значения, определенные методом, отправляющим сообщение. Это возможно для send метод, чтобы не установить JMSMessageID и JMSTimeStamp если установка этих заголовков явно отключается MessageProducer.setDisableMessageID или MessageProducer.setDisableMessageTimestamp метод.

Создание a MessageProducer обеспечивает те же самые функции как создающий a QueueSender. A MessageProducer объект рекомендуется, создавая новый код. QueueSender обеспечивается, чтобы поддерживать существующий код.

См. Также:

MessageProducer, Session.createProducer(Destination), QueueSession.createSender(Queue)

Сводка метода

Очередь	getQueue() Связали очередь с этим QueueSender.
void	send(Message message) Отправляет сообщение очереди.
void	send(Message message, int deliveryMode, int priority, long timeToLive) Отправляет сообщение очереди, определяя режим поставки, приоритет, и время, чтобы жить.
void	send(Queue queue, Message message) Отправляет сообщение очереди для неопознанного производителя сообщения.
void	send(Queue queue, Message message, int deliveryMode, int priority, long timeToLive) Отправляет сообщение очереди для неопознанного производителя сообщения, определяя режим поставки, приоритет и время, чтобы жить.

Методы, наследованные от интерфейса javax.jms. MessageProducer

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

Деталь метода

getQueue

Queue getQueue()
               throws JMSException

Связали очередь с этим QueueSender.

Возвраты:

очередь этого отправителя

Броски:

JMSException - если провайдер JMS не в состоянии получить очередь для этого QueueSender из-за некоторой внутренней ошибки.

передаться

void send(Message message)
          throws JMSException

Отправляет сообщение очереди. Использование QueueSender's режим поставки значения по умолчанию, приоритет, и время, чтобы жить.

Определенный:

send в интерфейсе MessageProducer

Параметры:

message - сообщение, чтобы передаться

Броски:

JMSException - если провайдер JMS не в состоянии отправить сообщение из-за некоторой внутренней ошибки.

MessageFormatException - если недопустимое сообщение определяется.

InvalidDestinationException - если клиент использует этот метод с a QueueSender с недопустимой очередью.

java.lang.UnsupportedOperationException - если клиент использует этот метод с a QueueSender во время создания это не определяло очередь.

См. Также:

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

передаться

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

Отправляет сообщение очереди, определяя режим поставки, приоритет, и время, чтобы жить.

Определенный:

send в интерфейсе MessageProducer

Параметры:

message - сообщение, чтобы передаться

deliveryMode - режим поставки, чтобы использовать

priority - приоритет для этого сообщения

timeToLive - время жизни сообщения (в миллисекундах)

Броски:

JMSException - если провайдер JMS не в состоянии отправить сообщение из-за некоторой внутренней ошибки.

MessageFormatException - если недопустимое сообщение определяется.

InvalidDestinationException - если клиент использует этот метод с a QueueSender с недопустимой очередью.

java.lang.UnsupportedOperationException - если клиент использует этот метод с a QueueSender во время создания это не определяло очередь.

См. Также:

Session.createProducer(javax.jms.Destination)

передаться

void send(Queue queue,
          Message message)
          throws JMSException

Отправляет сообщение очереди для неопознанного производителя сообщения. Использование QueueSender's режим поставки значения по умолчанию, приоритет, и время, чтобы жить.

Как правило, производитель сообщения присваивается очередь во время создания; однако, API JMS также поддерживает неопознанных производителей сообщения, которые требуют, чтобы очередь была предоставлена каждый раз, когда сообщение отправляется.

Параметры:

queue - очередь, чтобы отправить это сообщение

message - сообщение, чтобы передаться

Броски:

JMSException - если провайдер JMS не в состоянии отправить сообщение из-за некоторой внутренней ошибки.

MessageFormatException - если недопустимое сообщение определяется.

InvalidDestinationException - если клиент использует этот метод с недопустимой очередью.

См. Также:

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

передаться

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

Отправляет сообщение очереди для неопознанного производителя сообщения, определяя режим поставки, приоритет и время, чтобы жить.

Как правило, производитель сообщения присваивается очередь во время создания; однако, API JMS также поддерживает неопознанных производителей сообщения, которые требуют, чтобы очередь была предоставлена каждый раз, когда сообщение отправляется.

Параметры:

queue - очередь, чтобы отправить это сообщение

message - сообщение, чтобы передаться

deliveryMode - режим поставки, чтобы использовать

priority - приоритет для этого сообщения

timeToLive - время жизни сообщения (в миллисекундах)

Броски:

JMSException - если провайдер JMS не в состоянии отправить сообщение из-за некоторой внутренней ошибки.

MessageFormatException - если недопустимое сообщение определяется.

InvalidDestinationException - если клиент использует этот метод с недопустимой очередью.