Spec-Zone .ru
спецификации, руководства, описания, API
|
|
|||||||||
ПРЕДЫДУЩИЙ КЛАСС СЛЕДУЮЩИЙ КЛАСС | ФРЕЙМЫ НИКАКИЕ ФРЕЙМЫ | ||||||||
СВОДКА: ВЛОЖЕННЫЙ | ПОЛЕ | CONSTR | МЕТОД | ДЕТАЛЬ: ПОЛЕ | CONSTR | МЕТОД |
public interface TopicSubscriber
Клиент использует a TopicSubscriber
объект получить сообщения, которые были опубликованы к теме. A TopicSubscriber
объект является публиковать/подписываться формой потребителя сообщения. A MessageConsumer
может быть создан при использовании Session.createConsumer
.
A TopicSession
позволяет создание многократных TopicSubscriber
объекты на тему. Это передаст каждое сообщение для темы каждому подписчику, имеющему право получить это. Каждая копия сообщения обрабатывается как абсолютно отдельное сообщение. Работа, сделанная на одной копии, не имеет никакого эффекта на другие; подтверждение того не подтверждает другие; одно сообщение может быть сразу передано, в то время как другой ожидает его подписчика, чтобы обработать сообщения перед ним.
Регулярный TopicSubscriber
объекты не длительны. Они получают только сообщения, которые публикуются, в то время как они активные.
Сообщения, отфильтрованные селектором сообщения подписчика, никогда не будут передаваться подписчику. С точки зрения подписчика они не существуют.
В некоторых случаях соединение может и опубликовать и подписаться на тему. Подписчик NoLocal
атрибут позволяет подписчику подавлять поставку сообщений, опубликованных ее собственным соединением.
Если клиент должен получить все сообщения, опубликованные на теме, включая тех опубликованных, в то время как подписчик неактивен, она использует длительное TopicSubscriber
. Провайдер JMS сохраняет запись этой длительной подписки и обеспечивает, чтобы все сообщения от издателей темы были сохранены, пока они не подтверждаются этим длительным подписчиком, или они истекли.
Сеансы с длительными подписчиками должны всегда обеспечивать тот же самый клиентский идентификатор. Кроме того, каждый клиент должен определить имя, которое однозначно определяет (в пределах клиентского идентификатора) каждую длительную подписку, которую он создает. Только у одного сеанса за один раз может быть a TopicSubscriber
для определенной длительной подписки.
Клиент может изменить существующую длительную подписку, создавая длительное TopicSubscriber
с тем же самым именем и новой темой и/или селектором сообщения. Изменение длительной подписки эквивалентно отмене подписки (удаления) старого и создания нового.
unsubscribe
метод используется, чтобы удалить длительную подписку. unsubscribe
метод может использоваться в Session
или TopicSession
уровень. Этот метод удаляет состояние, сохраняемое от имени подписчика его провайдером.
Создание a MessageConsumer
обеспечивает те же самые функции как создающий a TopicSubscriber
. Создать длительного подписчика, использование Session.CreateDurableSubscriber
рекомендуется. TopicSubscriber
обеспечивается, чтобы поддерживать существующий код.
Session.createConsumer(javax.jms.Destination)
, Session.createDurableSubscriber(javax.jms.Topic, java.lang.String)
, TopicSession
, TopicSession.createSubscriber(javax.jms.Topic)
, MessageConsumer
Сводка метода | |
---|---|
boolean |
getNoLocal()
Добирается NoLocal атрибут для этого подписчика. |
Тема |
getTopic()
Добирается Topic связанный с этим подписчиком. |
Методы, наследованные от интерфейса javax.jms. MessageConsumer |
---|
close, getMessageListener, getMessageSelector, receive, receive, receiveNoWait, setMessageListener |
Деталь метода |
---|
Topic getTopic() throws JMSException
Topic
связанный с этим подписчиком.
Topic
JMSException
- если провайдер JMS не в состоянии получить тему для этого подписчика темы из-за некоторой внутренней ошибки.boolean getNoLocal() throws JMSException
NoLocal
атрибут для этого подписчика. Значение по умолчанию для этого атрибута является ложью.
JMSException
- если провайдер JMS не в состоянии добраться NoLocal
атрибут для этого подписчика темы из-за некоторой внутренней ошибки.
|
|||||||||
ПРЕДЫДУЩИЙ КЛАСС СЛЕДУЮЩИЙ КЛАСС | ФРЕЙМЫ НИКАКИЕ ФРЕЙМЫ | ||||||||
СВОДКА: ВЛОЖЕННЫЙ | ПОЛЕ | CONSTR | МЕТОД | ДЕТАЛЬ: ПОЛЕ | CONSTR | МЕТОД |
Авторское право © 2009-2011, Oracle Corporation и/или его филиалы. Все права защищены. Использование подвергается
Сгенерированный на 10-February-2011 12:41