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

javax.jms
Тема интерфейса

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

Место назначения

Все Известные Подынтерфейсы:

TemporaryTopic

public interface Topic
расширяет Место назначения

A Topic объект инкапсулирует специфичное для провайдера название темы. Это - способ, которым клиент определяет идентификационные данные темы к методам API JMS. Для тех методов то использование a Destination в качестве параметра, a Topic объект может используемый в качестве параметра. Например, Тема может использоваться, чтобы создать a MessageConsumer и a MessageProducer вызывая:

• Session.CreateConsumer(Destination destination)
• Session.CreateProducer(Destination destination)

Многие публикуют/подписываются (pub/sub) групповые темы провайдеров в иерархии и обеспечивают различные варианты для того, чтобы они подписались на части иерархии. API JMS не устанавливает ограничения для какой a Topic объект представляет. Это может быть лист в иерархии темы, или это может быть большая часть иерархии.

Организация тем и гранулярность подписок им являются важной частью архитектуры pub/sub приложения. API JMS не определяет политику для того, как это должно быть сделано. Если приложение использует в своих интересах специфичный для провайдера группирующий тему механизм, оно должно задокументировать это. Если приложение устанавливается, используя различного провайдера, это - задание администратора, чтобы создать эквивалентную архитектуру темы и создать эквивалентный Topic объекты.

См. Также:

Session#createConsumer(Destination), Session#createProducer(Destination), TopicSession.createTopic(String)

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

java.lang.String	getTopicName() Получает имя этой темы.
java.lang.String	toString() Возвращает строковое представление этого объекта.

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

getTopicName

java.lang.String getTopicName()
                              throws JMSException

Получает имя этой темы.

Клиенты, которые зависят от имени, не переносимы.

Возвраты:

название темы

Броски:

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

toString

java.lang.String toString()

Возвращает строковое представление этого объекта.

Переопределения:

toString в class java.lang.Object

Возвраты:

специфичные для провайдера идентификационные данные оценивают за эту тему