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


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

Все Известные Подынтерфейсы:
QueueSender, TopicPublisher

public interface MessageProducer

Клиент использует a MessageProducer объект отправить сообщения месту назначения. A MessageProducer объект создается, передавая a Destination возразите против метода создания производителя сообщения, предоставленного сеансом.

MessageProducer родительский интерфейс для всех производителей сообщения.

У клиента также есть опция создания производителя сообщения, не предоставляя место назначения. В этом случае месту назначения нужно предоставить каждый отправлять работу. Типичное использование для этого вида производителя сообщения должно отправить ответы на запросы, используя запрос JMSReplyTo место назначения.

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

Клиент может определить значение времени-к-живому в миллисекундах для каждого сообщения, которое оно отправляет. Это значение определяет время истечения срока сообщения, которое является суммой времени-к-живому сообщения и GMT, когда это отправляется (для проведенного, передается, это - время, которое клиент отправляет сообщению, не время, транзакция фиксируется).

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

См. Также:
TopicPublisher, QueueSender, Session.createProducer(javax.jms.Destination)

Сводка метода
 void close()
          Закрывает производителя сообщения.
 int getDeliveryMode()
          Получает режим поставки значения по умолчанию производителя.
 Место назначения getDestination()
          Связали место назначения с этим MessageProducer.
 boolean getDisableMessageID()
          Получает индикацию относительно того, запрещаются ли ID сообщения.
 boolean getDisableMessageTimestamp()
          Получает индикацию относительно того, запрещаются ли метки времени сообщения.
 int getPriority()
          Получает приоритет значения по умолчанию производителя.
 long getTimeToLive()
          Получает отрезок времени значения по умолчанию в миллисекундах от диспетчеризировать время, когда произведенное сообщение должно быть сохранено системой обмена сообщениями.
 void send(Destination destination, Message message)
          Отправляет сообщение месту назначения для неопознанного производителя сообщения.
 void send(Destination destination, Message message, int deliveryMode, int priority, long timeToLive)
          Отправляет сообщение месту назначения для неопознанного производителя сообщения, определяя режим поставки, приоритет и время, чтобы жить.
 void send(Message message)
          Отправляет сообщение, используя MessageProducer's режим поставки значения по умолчанию, приоритет, и время, чтобы жить.
 void send(Message message, int deliveryMode, int priority, long timeToLive)
          Отправляет сообщение месту назначения, определяя режим поставки, приоритет, и время, чтобы жить.
 void setDeliveryMode(int deliveryMode)
          Устанавливает режим поставки значения по умолчанию производителя.
 void setDisableMessageID(boolean value)
          Наборы, запрещаются ли ID сообщения.
 void setDisableMessageTimestamp(boolean value)
          Наборы, запрещаются ли метки времени сообщения.
 void setPriority(int defaultPriority)
          Устанавливает приоритет значения по умолчанию производителя.
 void setTimeToLive(long timeToLive)
          Устанавливает отрезок времени значения по умолчанию в миллисекундах от диспетчеризировать время, когда произведенное сообщение должно быть сохранено системой обмена сообщениями.
 

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

setDisableMessageID

void setDisableMessageID(boolean value)
                         throws JMSException
Наборы, запрещаются ли ID сообщения.

Так как ID сообщения берут некоторое усилие создать и увеличить размер сообщения, некоторые провайдеры JMS могут быть в состоянии оптимизировать издержки сообщения, если им дают подсказку, что ID сообщения не используется приложением. Вызывая setDisableMessageID метод на этом производителе сообщения, клиент JMS включает этой потенциальной оптимизации для всех сообщений, отправленных этим производителем сообщения. Если провайдер JMS принимает эту подсказку, у этих сообщений должен быть ID сообщения, устанавливают в NULL; если провайдер игнорирует подсказку, ID сообщения должен быть установлен в его нормальное уникальное значение.

ID сообщения включаются по умолчанию.

Параметры:
value - указывает, запрещаются ли ID сообщения
Броски:
JMSException - если провайдер JMS не в состоянии установить ID сообщения в отключенный из-за некоторой внутренней ошибки.

getDisableMessageID

boolean getDisableMessageID()
                            throws JMSException
Получает индикацию относительно того, запрещаются ли ID сообщения.

Возвраты:
индикация относительно того, запрещаются ли ID сообщения
Броски:
JMSException - если провайдер JMS не в состоянии определить, запрещаются ли ID сообщения из-за некоторой внутренней ошибки.

setDisableMessageTimestamp

void setDisableMessageTimestamp(boolean value)
                                throws JMSException
Наборы, запрещаются ли метки времени сообщения.

Так как метки времени берут некоторое усилие создать и увеличить размер сообщения, некоторые провайдеры JMS могут быть в состоянии оптимизировать издержки сообщения, если им дают подсказку, что метка времени не используется приложением. Вызывая setDisableMessageTimestamp метод на этом производителе сообщения, клиент JMS включает этой потенциальной оптимизации для всех сообщений, отправленных этим производителем сообщения. Если провайдер JMS принимает эту подсказку, этим сообщениям нужно было обнулить метку времени; если провайдер игнорирует подсказку, метка времени должна быть установлена в ее нормальное значение.

Метки времени сообщения включаются по умолчанию.

Параметры:
value - указывает, запрещаются ли метки времени сообщения
Броски:
JMSException - если провайдер JMS не в состоянии установить метки времени в отключенный из-за некоторой внутренней ошибки.

getDisableMessageTimestamp

boolean getDisableMessageTimestamp()
                                   throws JMSException
Получает индикацию относительно того, запрещаются ли метки времени сообщения.

Возвраты:
индикация относительно того, запрещаются ли метки времени сообщения
Броски:
JMSException - если провайдер JMS не в состоянии определить, запрещаются ли метки времени из-за некоторой внутренней ошибки.

setDeliveryMode

void setDeliveryMode(int deliveryMode)
                     throws JMSException
Устанавливает режим поставки значения по умолчанию производителя.

Режим поставки устанавливается в PERSISTENT по умолчанию.

Параметры:
deliveryMode - режим доставки сообщений для этого производителя сообщения; юридические значения DeliveryMode.NON_PERSISTENT и DeliveryMode.PERSISTENT
Броски:
JMSException - если провайдер JMS не в состоянии установить режим поставки из-за некоторой внутренней ошибки.
См. Также:
getDeliveryMode(), DeliveryMode.NON_PERSISTENT, DeliveryMode.PERSISTENT, Message.DEFAULT_DELIVERY_MODE

getDeliveryMode

int getDeliveryMode()
                    throws JMSException
Получает режим поставки значения по умолчанию производителя.

Возвраты:
режим доставки сообщений для этого производителя сообщения
Броски:
JMSException - если провайдер JMS не в состоянии получить режим поставки из-за некоторой внутренней ошибки.
См. Также:
setDeliveryMode(int)

setPriority

void setPriority(int defaultPriority)
                 throws JMSException
Устанавливает приоритет значения по умолчанию производителя.

API JMS определяет десять уровней приоритетного значения, с 0 как самый низкий приоритет и 9 как самое высокое. Клиенты должны рассмотреть приоритеты 0-4 как градации нормального приоритета и приоритетов 5-9 как градации ускоренного приоритета. Приоритет устанавливается в 4 по умолчанию.

Параметры:
defaultPriority - приоритет сообщения для этого производителя сообщения; должно быть значение между 0 и 9
Броски:
JMSException - если провайдер JMS не в состоянии установить приоритет из-за некоторой внутренней ошибки.
См. Также:
getPriority(), Message.DEFAULT_PRIORITY

getPriority

int getPriority()
                throws JMSException
Получает приоритет значения по умолчанию производителя.

Возвраты:
приоритет сообщения для этого производителя сообщения
Броски:
JMSException - если провайдер JMS не в состоянии получить приоритет из-за некоторой внутренней ошибки.
См. Также:
setPriority(int)

setTimeToLive

void setTimeToLive(long timeToLive)
                   throws JMSException
Устанавливает отрезок времени значения по умолчанию в миллисекундах от диспетчеризировать время, когда произведенное сообщение должно быть сохранено системой обмена сообщениями.

Время, чтобы жить обнуляется по умолчанию.

Параметры:
timeToLive - время сообщения, чтобы жить в миллисекундах; нуль неограничен
Броски:
JMSException - если провайдер JMS не в состоянии установить время, чтобы жить из-за некоторой внутренней ошибки.
См. Также:
getTimeToLive(), Message.DEFAULT_TIME_TO_LIVE

getTimeToLive

long getTimeToLive()
                   throws JMSException
Получает отрезок времени значения по умолчанию в миллисекундах от диспетчеризировать время, когда произведенное сообщение должно быть сохранено системой обмена сообщениями.

Возвраты:
время сообщения, чтобы жить в миллисекундах; нуль неограничен
Броски:
JMSException - если провайдер JMS не в состоянии заставить время жить из-за некоторой внутренней ошибки.
См. Также:
setTimeToLive(long)

getDestination

Destination getDestination()
                           throws JMSException
Связали место назначения с этим MessageProducer.

Возвраты:
этот производитель Destination/
Throws:
JMSException - if the JMS provider fails to get the destination for this MessageProducer due to some internal error.
Since:
1.1

close

void close()
           throws JMSException
Closes the message producer.

Since a provider may allocate some resources on behalf of a MessageProducer outside the Java virtual machine, clients should close them when they are not needed. Relying on garbage collection to eventually reclaim these resources may not be timely enough.

Throws:
JMSException - if the JMS provider fails to close the producer due to some internal error.

send

void send(Message message)
          throws JMSException
Sends a message using the MessageProducer's default delivery mode, priority, and time to live.

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.
java.lang.UnsupportedOperationException - if a client uses this method with a MessageProducer that did not specify a destination at creation time.
Since:
1.1
See Also:
Session.createProducer(javax.jms.Destination), MessageProducer

send

void send(Message message,
          int deliveryMode,
          int priority,
          long timeToLive)
          throws JMSException
Sends a message to the destination, specifying delivery mode, priority, and time to live.

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)
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.
java.lang.UnsupportedOperationException - if a client uses this method with a MessageProducer that did not specify a destination at creation time.
Since:
1.1
See Also:
Session.createProducer(javax.jms.Destination)

send

void send(Destination destination,
          Message message)
          throws JMSException
Sends a message to a destination for an unidentified message producer. Uses the MessageProducer's default delivery mode, priority, and time to live.

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

Parameters:
destination - the destination 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 destination.
java.lang.UnsupportedOperationException - if a client uses this method with a MessageProducer that specified a destination at creation time.
Since:
1.1
See Also:
Session.createProducer(javax.jms.Destination), MessageProducer

send

void send(Destination destination,
          Message message,
          int deliveryMode,
          int priority,
          long timeToLive)
          throws JMSException
Sends a message to a destination for an unidentified message producer, specifying delivery mode, priority and time to live.

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

Parameters:
destination - the destination 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)
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 destination.
Since:
1.1
See Also:
Session.createProducer(javax.jms.Destination)


Представьте ошибку или функцию

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

free hit counter