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

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 - если клиент использует этот метод с недопустимой темой.