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

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

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

Клиент использует a TopicPublisher объект опубликовать сообщения на теме. A TopicPublisher объект является публиковать - подписывают форму производителя сообщения.

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

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

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

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

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

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

Поскольку TopicPublisher наследовался от MessageProducer, это наследовалось send методы, которые являются частью MessageProducer интерфейс. Используя send методы будут иметь тот же самый эффект как использование publish методы: они - функционально то же самое.

См. Также:
Session#createProducer(Destination), TopicSession#createPublisher(Topic)

Сводка метода
 Тема getTopic()
          Связали тему с этим TopicPublisher.
 void publish(Message message)
          Публикует сообщение к теме.
 void publish(Message message, int deliveryMode, int priority, long timeToLive)
          Публикует сообщение к теме, определяя режим поставки, приоритет, и время, чтобы жить.
 void publish(Topic topic, Message message)
          Публикует сообщение к теме для неопознанного производителя сообщения.
 void publish(Topic topic, Message message, int deliveryMode, int priority, long timeToLive)
          Публикует сообщение к теме для неопознанного производителя сообщения, определяя режим поставки, приоритет и время, чтобы жить.
 
Методы, наследованные от интерфейса javax.jms. MessageProducer
close, getDeliveryMode, getDestination, getDisableMessageID, getDisableMessageTimestamp, getPriority, getTimeToLive, send, send, send, send, setDeliveryMode, setDisableMessageID, setDisableMessageTimestamp, setPriority, setTimeToLive
 

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

getTopic

Topic getTopic()
               throws JMSException
Связали тему с этим TopicPublisher.

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

опубликовать

void publish(Message message)
             throws JMSException
Публикует сообщение к теме. Использование TopicPublisher's режим поставки значения по умолчанию, приоритет, и время, чтобы жить.

Параметры:
message - сообщение, чтобы опубликовать
Броски:
JMSException - если провайдер JMS не в состоянии опубликовать сообщение из-за некоторой внутренней ошибки.
MessageFormatException - если недопустимое сообщение определяется.
InvalidDestinationException - если клиент использует этот метод с a TopicPublisher с недопустимой темой.
java.lang.UnsupportedOperationException - если клиент использует этот метод с a TopicPublisher во время создания это не определяло тему.
См. Также:
MessageProducer.getDeliveryMode(), MessageProducer.getTimeToLive(), MessageProducer.getPriority()

опубликовать

void publish(Message message,
             int deliveryMode,
             int priority,
             long timeToLive)
             throws JMSException
Публикует сообщение к теме, определяя режим поставки, приоритет, и время, чтобы жить.

Параметры:
message - сообщение, чтобы опубликовать
deliveryMode - режим поставки, чтобы использовать
priority - приоритет для этого сообщения
timeToLive - время жизни сообщения (в миллисекундах)
Броски:
JMSException - если провайдер JMS не в состоянии опубликовать сообщение из-за некоторой внутренней ошибки.
MessageFormatException - если недопустимое сообщение определяется.
InvalidDestinationException - если клиент использует этот метод с a TopicPublisher с недопустимой темой.
java.lang.UnsupportedOperationException - если клиент использует этот метод с a TopicPublisher во время создания это не определяло тему.

опубликовать

void publish(Topic topic,
             Message message)
             throws JMSException
Публикует сообщение к теме для неопознанного производителя сообщения. Использование TopicPublisher's режим поставки значения по умолчанию, приоритет, и время, чтобы жить.

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

Параметры:
topic - тема, чтобы опубликовать это сообщение к
message - сообщение, чтобы опубликовать
Броски:
JMSException - если провайдер JMS не в состоянии опубликовать сообщение из-за некоторой внутренней ошибки.
MessageFormatException - если недопустимое сообщение определяется.
InvalidDestinationException - если клиент использует этот метод с недопустимой темой.
См. Также:
MessageProducer.getDeliveryMode(), MessageProducer.getTimeToLive(), MessageProducer.getPriority()

опубликовать

void publish(Topic topic,
             Message message,
             int deliveryMode,
             int priority,
             long timeToLive)
             throws JMSException
Публикует сообщение к теме для неопознанного производителя сообщения, определяя режим поставки, приоритет и время, чтобы жить.

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

Параметры:
topic - тема, чтобы опубликовать это сообщение к
message - сообщение, чтобы опубликовать
deliveryMode - режим поставки, чтобы использовать
priority - приоритет для этого сообщения
timeToLive - время жизни сообщения (в миллисекундах)
Броски:
JMSException - если провайдер JMS не в состоянии опубликовать сообщение из-за некоторой внутренней ошибки.
MessageFormatException - если недопустимое сообщение определяется.
InvalidDestinationException - если клиент использует этот метод с недопустимой темой.


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

Авторское право © 2009-2011, Oracle Corporation и/или его филиалы. Все права защищены. Использование подвергается срокам действия лицензии.

Сгенерированный на 10-February-2011 12:41


Spec-Zone.ru - all specs in one place



free hit counter