Spec-Zone .ru
спецификации, руководства, описания, API
|
|
|||||||||
ПРЕДЫДУЩИЙ КЛАСС СЛЕДУЮЩИЙ КЛАСС | ФРЕЙМЫ НИКАКИЕ ФРЕЙМЫ | ||||||||
СВОДКА: ВЛОЖЕННЫЙ | ПОЛЕ | CONSTR | МЕТОД | ДЕТАЛЬ: ПОЛЕ | CONSTR | МЕТОД |
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)
Устанавливает отрезок времени значения по умолчанию в миллисекундах от диспетчеризировать время, когда произведенное сообщение должно быть сохранено системой обмена сообщениями. |
Деталь метода |
---|
void setDisableMessageID(boolean value) throws JMSException
Так как ID сообщения берут некоторое усилие создать и увеличить размер сообщения, некоторые провайдеры JMS могут быть в состоянии оптимизировать издержки сообщения, если им дают подсказку, что ID сообщения не используется приложением. Вызывая setDisableMessageID
метод на этом производителе сообщения, клиент JMS включает этой потенциальной оптимизации для всех сообщений, отправленных этим производителем сообщения. Если провайдер JMS принимает эту подсказку, у этих сообщений должен быть ID сообщения, устанавливают в NULL; если провайдер игнорирует подсказку, ID сообщения должен быть установлен в его нормальное уникальное значение.
ID сообщения включаются по умолчанию.
value
- указывает, запрещаются ли ID сообщения JMSException
- если провайдер JMS не в состоянии установить ID сообщения в отключенный из-за некоторой внутренней ошибки.boolean getDisableMessageID() throws JMSException
JMSException
- если провайдер JMS не в состоянии определить, запрещаются ли ID сообщения из-за некоторой внутренней ошибки.void setDisableMessageTimestamp(boolean value) throws JMSException
Так как метки времени берут некоторое усилие создать и увеличить размер сообщения, некоторые провайдеры JMS могут быть в состоянии оптимизировать издержки сообщения, если им дают подсказку, что метка времени не используется приложением. Вызывая setDisableMessageTimestamp
метод на этом производителе сообщения, клиент JMS включает этой потенциальной оптимизации для всех сообщений, отправленных этим производителем сообщения. Если провайдер JMS принимает эту подсказку, этим сообщениям нужно было обнулить метку времени; если провайдер игнорирует подсказку, метка времени должна быть установлена в ее нормальное значение.
Метки времени сообщения включаются по умолчанию.
value
- указывает, запрещаются ли метки времени сообщения JMSException
- если провайдер JMS не в состоянии установить метки времени в отключенный из-за некоторой внутренней ошибки.boolean getDisableMessageTimestamp() throws JMSException
JMSException
- если провайдер JMS не в состоянии определить, запрещаются ли метки времени из-за некоторой внутренней ошибки.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
int getDeliveryMode() throws JMSException
JMSException
- если провайдер JMS не в состоянии получить режим поставки из-за некоторой внутренней ошибки.setDeliveryMode(int)
void setPriority(int defaultPriority) throws JMSException
API JMS определяет десять уровней приоритетного значения, с 0 как самый низкий приоритет и 9 как самое высокое. Клиенты должны рассмотреть приоритеты 0-4 как градации нормального приоритета и приоритетов 5-9 как градации ускоренного приоритета. Приоритет устанавливается в 4 по умолчанию.
defaultPriority
- приоритет сообщения для этого производителя сообщения; должно быть значение между 0 и 9 JMSException
- если провайдер JMS не в состоянии установить приоритет из-за некоторой внутренней ошибки.getPriority()
, Message.DEFAULT_PRIORITY
int getPriority() throws JMSException
JMSException
- если провайдер JMS не в состоянии получить приоритет из-за некоторой внутренней ошибки.setPriority(int)
void setTimeToLive(long timeToLive) throws JMSException
Время, чтобы жить обнуляется по умолчанию.
timeToLive
- время сообщения, чтобы жить в миллисекундах; нуль неограничен JMSException
- если провайдер JMS не в состоянии установить время, чтобы жить из-за некоторой внутренней ошибки.getTimeToLive()
, Message.DEFAULT_TIME_TO_LIVE
long getTimeToLive() throws JMSException
JMSException
- если провайдер JMS не в состоянии заставить время жить из-за некоторой внутренней ошибки.setTimeToLive(long)
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
void close() throws JMSException
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.
JMSException
- if the JMS provider fails to close the producer due to some internal error.void send(Message message) throws JMSException
MessageProducer
's default delivery mode, priority, and time to live.
message
- the message to send 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.Session.createProducer(javax.jms.Destination)
, MessageProducer
void send(Message message, int deliveryMode, int priority, long timeToLive) throws JMSException
message
- the message to senddeliveryMode
- the delivery mode to usepriority
- the priority for this messagetimeToLive
- the message's lifetime (in milliseconds) 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.Session.createProducer(javax.jms.Destination)
void send(Destination destination, Message message) throws JMSException
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.
destination
- the destination to send this message tomessage
- the message to send 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.Session.createProducer(javax.jms.Destination)
, MessageProducer
void send(Destination destination, Message message, int deliveryMode, int priority, long timeToLive) throws JMSException
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.
destination
- the destination to send this message tomessage
- the message to senddeliveryMode
- the delivery mode to usepriority
- the priority for this messagetimeToLive
- the message's lifetime (in milliseconds) 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.Session.createProducer(javax.jms.Destination)
|
|||||||||
ПРЕДЫДУЩИЙ КЛАСС СЛЕДУЮЩИЙ КЛАСС | ФРЕЙМЫ НИКАКИЕ ФРЕЙМЫ | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Copyright © 2009-2011, Oracle Corporation and/or its affiliates. All Rights Reserved. Use is subject to
Generated on 10-February-2011 12:41