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

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

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

java.lang. Выполнимый, Сеанс

public interface TopicSession
расширяет Сеанс

A TopicSession объект обеспечивает методы для того, чтобы они создали TopicPublisher, TopicSubscriber, и TemporaryTopic объекты. Это также обеспечивает метод для того, чтобы он удалил длительных подписчиков его клиента.

A TopicSession используется для того, чтобы создать конкретные цели Pub/Sub. Вообще, используйте Session объект, и использование TopicSession только поддерживать существующий код. Используя Session объект упрощает модель программирования, и позволяет транзакциям использоваться через два домена обмена сообщениями.

A TopicSession не может использоваться, чтобы создать объекты, определенные для домена "точка-точка". Следующие методы наследовались от Session, но должен бросить IllegalStateException если использующийся от TopicSession:

• createBrowser
• createQueue
• createTemporaryQueue

См. Также:

Session, Connection.createSession(boolean, int), TopicConnection.createTopicSession(boolean, int), XATopicSession.getTopicSession()

Полевая Сводка

Поля, наследованные от интерфейса javax.jms. Сеанс

AUTO_ACKNOWLEDGE, CLIENT_ACKNOWLEDGE, DUPS_OK_ACKNOWLEDGE, SESSION_TRANSACTED

Сводка метода

TopicSubscriber	createDurableSubscriber(Topic topic, java.lang.String name) Создает длительного подписчика к указанной теме.
TopicSubscriber	createDurableSubscriber(Topic topic, java.lang.String name, java.lang.String messageSelector, boolean noLocal) Создает длительного подписчика к указанной теме, используя селектор сообщения или определяя, должны ли сообщения, опубликованные его собственным соединением, быть переданы к этому.
TopicPublisher	createPublisher(Topic topic) Создает издателя для указанной темы.
TopicSubscriber	createSubscriber(Topic topic) Создает недолговременного подписчика к указанной теме.
TopicSubscriber	createSubscriber(Topic topic, java.lang.String messageSelector, boolean noLocal) Создает недолговременного подписчика к указанной теме, используя селектор сообщения или определяя, должны ли сообщения, опубликованные его собственным соединением, быть переданы к этому.
TemporaryTopic	createTemporaryTopic() Создает a TemporaryTopic объект.
Тема	createTopic(java.lang.String topicName) Создает идентификационные данные темы, данные a Topic имя.
void	unsubscribe(java.lang.String name) Отписывает длительную подписку, которая была создана клиентом.

Методы, наследованные от интерфейса javax.jms. Сеанс

close, commit, createBrowser, createBrowser, createBytesMessage, createConsumer, createConsumer, createConsumer, createMapMessage, createMessage, createObjectMessage, createObjectMessage, createProducer, createQueue, createStreamMessage, createTemporaryQueue, createTextMessage, createTextMessage, getAcknowledgeMode, getMessageListener, getTransacted, recover, rollback, run, setMessageListener

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

createTopic

Topic createTopic(java.lang.String topicName)
                  throws JMSException

Создает идентификационные данные темы, данные a Topic имя.

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

Отметьте, что этот метод не для того, чтобы создать физическую тему. Физическое создание тем является задачей администрирования и не должно инициироваться API JMS. Одно исключение является созданием временных тем, которое выполняется с createTemporaryTopic метод.

Определенный:

createTopic в интерфейсе Session

Параметры:

topicName - имя этого Topic

Возвраты:

a Topic с именем

Броски:

JMSException - если сеанс не в состоянии создать тему из-за некоторой внутренней ошибки.

createSubscriber

TopicSubscriber createSubscriber(Topic topic)
                                 throws JMSException

Создает недолговременного подписчика к указанной теме.

Клиент использует a TopicSubscriber объект получить сообщения, которые были опубликованы к теме.

Регулярный TopicSubscriber объекты не длительны. Они получают только сообщения, которые публикуются, в то время как они активные.

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

Параметры:

topic - Topic подписываться на

Броски:

JMSException - если сеанс не в состоянии создать подписчика из-за некоторой внутренней ошибки.

InvalidDestinationException - если недопустимая тема определяется.

createSubscriber

TopicSubscriber createSubscriber(Topic topic,
                                 java.lang.String messageSelector,
                                 boolean noLocal)
                                 throws JMSException

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

Клиент использует a TopicSubscriber объект получить сообщения, которые были опубликованы к теме.

Регулярный TopicSubscriber объекты не длительны. Они получают только сообщения, которые публикуются, в то время как они активные.

Сообщения, отфильтрованные селектором сообщения подписчика, никогда не будут передаваться подписчику. С точки зрения подписчика они не существуют.

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

Параметры:

topic - Topic подписываться на

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

noLocal - если установлено, запрещает поставку сообщений, опубликованных ее собственным соединением

Броски:

JMSException - если сеанс не в состоянии создать подписчика из-за некоторой внутренней ошибки.

InvalidDestinationException - если недопустимая тема определяется.

InvalidSelectorException - если селектор сообщения недопустим.

createDurableSubscriber

TopicSubscriber createDurableSubscriber(Topic topic,
                                        java.lang.String name)
                                        throws JMSException

Создает длительного подписчика к указанной теме.

Если клиент должен получить все сообщения, опубликованные на теме, включая тех опубликованных, в то время как подписчик неактивен, она использует длительное TopicSubscriber. Провайдер JMS сохраняет запись этой длительной подписки и обеспечивает, чтобы все сообщения от издателей темы были сохранены, пока они не подтверждаются этим длительным подписчиком, или они истекли.

Сеансы с длительными подписчиками должны всегда обеспечивать тот же самый клиентский идентификатор. Кроме того, каждый клиент должен определить имя, которое однозначно определяет (в пределах клиентского идентификатора) каждую длительную подписку, которую он создает. Только у одного сеанса за один раз может быть a TopicSubscriber для определенной длительной подписки.

Клиент может изменить существующую длительную подписку, создавая длительное TopicSubscriber с тем же самым именем и новой темой и/или селектором сообщения. Изменение длительного подписчика эквивалентно отмене подписки (удаления) старого и создания нового.

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

Определенный:

createDurableSubscriber в интерфейсе Session

Параметры:

topic - невременное Topic подписываться на

name - имя, используемое, чтобы идентифицировать эту подписку

Броски:

JMSException - если сеанс не в состоянии создать подписчика из-за некоторой внутренней ошибки.

InvalidDestinationException - если недопустимая тема определяется.

createDurableSubscriber

TopicSubscriber createDurableSubscriber(Topic topic,
                                        java.lang.String name,
                                        java.lang.String messageSelector,
                                        boolean noLocal)
                                        throws JMSException

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

Если клиент должен получить все сообщения, опубликованные на теме, включая тех опубликованных, в то время как подписчик неактивен, она использует длительное TopicSubscriber. Провайдер JMS сохраняет запись этой длительной подписки и обеспечивает, чтобы все сообщения от издателей темы были сохранены, пока они не подтверждаются этим длительным подписчиком, или они истекли.

Сеансы с длительными подписчиками должны всегда обеспечивать тот же самый клиентский идентификатор. Кроме того, каждый клиент должен определить имя, которое однозначно определяет (в пределах клиентского идентификатора) каждую длительную подписку, которую он создает. Только у одного сеанса за один раз может быть a TopicSubscriber для определенной длительной подписки. Неактивный длительный подписчик является тем, который существует, но в настоящий момент не связывал потребителя сообщения с этим.

Клиент может изменить существующую длительную подписку, создавая длительное TopicSubscriber с тем же самым именем и новой темой и/или селектором сообщения. Изменение длительного подписчика эквивалентно отмене подписки (удаления) старого и создания нового.

Определенный:

createDurableSubscriber в интерфейсе Session

Параметры:

topic - невременное Topic подписываться на

name - имя, используемое, чтобы идентифицировать эту подписку

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

noLocal - если установлено, запрещает поставку сообщений, опубликованных ее собственным соединением

Броски:

JMSException - если сеанс не в состоянии создать подписчика из-за некоторой внутренней ошибки.

InvalidDestinationException - если недопустимая тема определяется.

InvalidSelectorException - если селектор сообщения недопустим.

createPublisher

TopicPublisher createPublisher(Topic topic)
                               throws JMSException

Создает издателя для указанной темы.

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

Параметры:

topic - Topic опубликовать к, или нуль, если это - неопознанный производитель

Броски:

JMSException - если сеанс не в состоянии создать издателя из-за некоторой внутренней ошибки.

InvalidDestinationException - если недопустимая тема определяется.

createTemporaryTopic

TemporaryTopic createTemporaryTopic()
                                    throws JMSException

Создает a TemporaryTopic объект. Его время жизни будет временем жизни TopicConnection если это не удаляется ранее.

Определенный:

createTemporaryTopic в интерфейсе Session

Возвраты:

временные идентификационные данные темы

Броски:

JMSException - если сеанс не в состоянии создать временную тему из-за некоторой внутренней ошибки.

отписаться

void unsubscribe(java.lang.String name)
                 throws JMSException

Отписывает длительную подписку, которая была создана клиентом.

Этот метод удаляет состояние, сохраняемое от имени подписчика его провайдером.

Это ошибочно для клиента, чтобы удалить длительную подписку, в то время как есть активное TopicSubscriber для подписки, или в то время как использованное сообщение является частью транзакции на ожидании или не было подтверждено в сеансе.

Определенный:

unsubscribe в интерфейсе Session

Параметры:

name - имя, используемое, чтобы идентифицировать эту подписку

Броски:

JMSException - если сеанс не в состоянии отписаться к длительной подписке из-за некоторой внутренней ошибки.

InvalidDestinationException - если недопустимое имя подписки определяется.