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

Пакет javax.jms

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

См.:
Описание

Сводка интерфейса

BytesMessage	A BytesMessage объект используется, чтобы отправить сообщение, содержащее поток неинтерпретируемых байтов.
Соединение	A Connection объект является активным соединением клиента со своим провайдером JMS.
ConnectionConsumer	Для серверов приложений, Connection объекты предоставляют специальное средство для того, чтобы оно создало a ConnectionConsumer (дополнительный).
ConnectionFactory	A ConnectionFactory объект инкапсулирует ряд параметров конфигурации соединения, который был определен администратором.
ConnectionMetaData	A ConnectionMetaData объект предоставляет информацию, описывающую Connection объект.
DeliveryMode	Режимы поставки, поддерживаемые API JMS, PERSISTENT и NON_PERSISTENT.
Место назначения	A Destination объект инкапсулирует специфичный для провайдера адрес.
ExceptionListener	Если провайдер JMS обнаруживает серьёзную проблему с a Connection объект, это сообщает Connection объект ExceptionListener, если Вы были зарегистрированы.
MapMessage	A MapMessage объект используется, чтобы отправить ряд пар значение-имя.
Сообщение	Message интерфейс является корневым интерфейсом всех сообщений JMS.
MessageConsumer	Клиент использует a MessageConsumer объект получить сообщения от места назначения.
MessageListener	A MessageListener объект используется, чтобы получить асинхронно переданные сообщения.
MessageProducer	Клиент использует a MessageProducer объект отправить сообщения месту назначения.
ObjectMessage	ObjectMessage объект используется, чтобы отправить сообщение, которое содержит сериализуемый объект в языке программирования Java ("объект Java").
Очередь	A Queue объект инкапсулирует специфичное для провайдера имя очереди.
QueueBrowser	Клиент использует a QueueBrowser возразите, чтобы смотреть на сообщения на очереди, не удаляя их.
QueueConnection	A QueueConnection объект является активным соединением с провайдером JMS "точка-точка".
QueueConnectionFactory	Клиент использует a QueueConnectionFactory объект создать QueueConnection объекты с провайдером JMS "точка-точка".
QueueReceiver	Клиент использует a QueueReceiver объект получить сообщения, которые были переданы очереди.
QueueSender	Клиент использует a QueueSender объект отправить сообщения очереди.
QueueSession	A QueueSession объект обеспечивает методы для того, чтобы они создали QueueReceiver, QueueSender, QueueBrowser, и TemporaryQueue объекты.
ServerSession	A ServerSession объект является объектом сервера приложений, который используется сервером, чтобы связать поток с (дополнительным) сеансом JMS.
ServerSessionPool	A ServerSessionPool объект является объектом, реализованным сервером приложений, чтобы обеспечить пул ServerSession объекты для того, чтобы обработать сообщения a ConnectionConsumer (дополнительный).
Сеанс	A Session объект является однопоточным контекстом для создания и потребления сообщений.
StreamMessage	A StreamMessage объект используется, чтобы отправить поток типов примитивов в языке программирования Java.
TemporaryQueue	A TemporaryQueue объект является уникальным Queue объект создается для продолжительности a Connection.
TemporaryTopic	A TemporaryTopic объект является уникальным Topic объект создается для продолжительности a Connection.
TextMessage	A TextMessage объект используется, чтобы отправить сообщение, содержащее a java.lang.String.
Тема	A Topic объект инкапсулирует специфичное для провайдера название темы.
TopicConnection	A TopicConnection объект является активным соединением с публикованием/подписывание провайдера JMS.
TopicConnectionFactory	Клиент использует a TopicConnectionFactory объект создать TopicConnection объекты с публикованием/подписывание провайдера JMS.
TopicPublisher	Клиент использует a TopicPublisher объект опубликовать сообщения на теме.
TopicSession	A TopicSession объект обеспечивает методы для того, чтобы они создали TopicPublisher, TopicSubscriber, и TemporaryTopic объекты.
TopicSubscriber	Клиент использует a TopicSubscriber объект получить сообщения, которые были опубликованы к теме.
XAConnection	XAConnection интерфейс расширяет возможность Connection обеспечивая XASession (дополнительный).
XAConnectionFactory	XAConnectionFactory интерфейс является основным интерфейсом для XAQueueConnectionFactory и XATopicConnectionFactory интерфейсы.
XAQueueConnection	XAQueueConnection обеспечивает то же самое создают опции как QueueConnection (дополнительный).
XAQueueConnectionFactory	XAQueueConnectionFactory обеспечивает то же самое создают опции как a QueueConnectionFactory (дополнительный).
XAQueueSession	XAQueueSession предоставляет постоянному клиенту QueueSession, который может использоваться, чтобы создать QueueReceiver, QueueSender, и QueueBrowser (дополнительные) объекты.
XASession	XASession интерфейс расширяет возможность Session добавляя доступ к поддержке провайдера JMS API Транзакции Java (дополнительный) (JTA).
XATopicConnection	XATopicConnection обеспечивает то же самое создают опции как TopicConnection (дополнительный).
XATopicConnectionFactory	XATopicConnectionFactory обеспечивает то же самое создают опции как a TopicConnectionFactory (дополнительный).
XATopicSession	XATopicSession предоставляет постоянному клиенту TopicSession.

Сводка класса

QueueRequestor	QueueRequestor помощник class упрощает запросы на обслуживание создания.
TopicRequestor	TopicRequestor помощник class упрощает запросы на обслуживание создания.

Сводка исключения

IllegalStateException	Это исключение выдается, когда метод вызывается в недопустимое или несоответствующее время или если провайдер не находится в соответствующем состоянии для требуемой работы.
InvalidClientIDException	Это исключение должно быть выдано, когда клиент пытается установить клиентский ID соединения в значение, которое отклоняется провайдером.
InvalidDestinationException	Это исключение должно быть выдано, когда место назначения или не понимается под провайдером или больше не действительно.
InvalidSelectorException	Это исключение должно быть выдано, когда клиент JMS пытается дать провайдеру селектор сообщения с недопустимым синтаксисом.
JMSException	Это - корневой class всех исключений API JMS.
JMSSecurityException	Это исключение должно быть выдано, когда провайдер отклоняет имя пользователя / пароль, представленный клиентом.
MessageEOFException	Это исключение должно быть выдано, когда неожиданный конец потока был достигнут когда a StreamMessage или BytesMessage читается.
MessageFormatException	Это исключение должно быть выдано, когда клиент JMS пытается использовать тип данных, не поддерживаемый сообщением или попытками считать данные в сообщении как неправильный тип.
MessageNotReadableException	Это исключение должно быть выдано, когда клиент JMS пытается считать сообщение только для записи.
MessageNotWriteableException	Это исключение должно быть выдано, когда клиент JMS пытается записать в сообщение только для чтения.
ResourceAllocationException	Это исключение выдается, когда провайдер неспособен выделить ресурсы, требуемые методом.
TransactionInProgressException	Это исключение выдается, когда работа недопустима, потому что транзакция происходит.
TransactionRolledBackException	Это исключение должно быть выдано когда звонок Session.commit результаты в откате текущей транзакции.

Пакет javax.jms Описание

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

Приложения JMS

Приложение JMS составляется из следующих частей:

• Провайдер JMS - система обмена сообщениями, которая реализует API JMS в дополнение к другой административной функциональности и функциональности управления, требуемой полнофункционального продукта обмена сообщениями
• Клиенты JMS - программы языка Java, которые отправляют и получают сообщения
• Сообщения - объекты, которые используются, чтобы передать информацию между клиентами приложения
• Администрируемые Объекты - специфичные для провайдера объекты, которые клиенты ищут и используют, чтобы взаимодействовать портативно с провайдером JMS
• Клиенты Non-JMS - клиенты, которые используют собственный клиентский API системы обмена сообщениями вместо API JMS. Если приложение, преследуемое доступность API JMS, вероятно, что это будет включать и клиенты JMS и non-JMS клиенты.

Администрирование

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

Для клиентов JMS, чтобы быть переносимыми, они должны быть изолированы от этих собственных аспектов провайдера. Это делается, определяя JMS администрируемые объекты, которые создаются и настраиваются администратором провайдера и позже используются клиентами. Клиент использует их через интерфейсы JMS, которые переносимы. Администратор создает их использующий специфичные для провайдера средства.

Есть два типа JMS администрируемые объекты:

• ConnectionFactory - объект клиент использует, чтобы создать соединение с провайдером JMS
• Место назначения - объект, который клиент использует, чтобы определить место назначения сообщений, которые он отправляет и источник сообщений, которые он получает

Администрируемые объекты помещаются в Именование Java и Каталог ^InterfaceTM (JNDI) пространство имен администратором. Клиент JMS обычно отмечает в его документации JMS администрируемые объекты, которых он требует и как имена JNDI этих объектов должны быть обеспечены для него.

Два Стиля Обмена сообщениями

Спецификация JMS определяет два стиля обмена сообщениями: "точка-точка" (PTP) или публиковать-и-подписываться (Pub/Sub). Эти стили могут быть объединены в единственном приложении, или данное приложение может использовать только один из этих стилей.

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

Интерфейсы JMS

Программируя клиент приложения, программист может или программировать использование зависящих от домена интерфейсов, или может использовать общие интерфейсы. Ключевые интерфейсы перечисляются в таблице ниже. Привилегированная модель должна использовать общие интерфейсы. Преимущество для использования общих интерфейсов состоит в том, что и и pub/sub задачи "точка-точка" могут быть объединены в одном сеансе, позволяя транзакции работать свыше обоих доменов.

В более ранних версиях JMS были отдельные иерархии class для pub/sub и моделей программирования "точка-точка", которые должны были использоваться. Эти иерархии class сохраняются, чтобы поддерживать обратную совместимость с более ранними версиями API JMS, но клиентские разработчики поощряются использовать общие интерфейсы.

Отношение PTP и интерфейсов Pub/Sub

Распространенный JMS	Домен PTP	Домен Pub/Sub
ConnectionFactory	QueueConnectionFactory	TopicConnectionFactory
Соединение	QueueConnection	TopicConnection
Место назначения	Очередь	Тема
Сеанс	QueueSession	TopicSession
MessageProducer	QueueSender	TopicPublisher
MessageConsumer	QueueReceiver	TopicSubscriber

Следующее обеспечивает краткое определение этих понятий JMS. См. PTP и главы Pub/Sub спецификации JMS для получения дополнительной информации.

• ConnectionFactory - администрируемый объект, используемый клиентом, чтобы создать Соединение
• Соединение - активное соединение с провайдером JMS
• Место назначения - администрируемый объект, который инкапсулирует идентификационные данные места назначения сообщения
• Сеанс - однопоточный контекст для отправки и получения сообщений
• MessageProducer - объект, создаваемый Сеансом, который используется для того, чтобы отправить сообщения месту назначения
• MessageConsumer - объект, создаваемый Сеансом, который используется для того, чтобы получить сообщения, отправленные месту назначения

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

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

Разрабатывание Приложения JMS

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

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

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

Разработка Клиента JMS

Типичный клиент JMS выполняет следующую процедуру установки:

• Используйте JNDI, чтобы найти объект ConnectionFactory
• Используйте JNDI, чтобы найти один или более Целевых объектов
• Используйте ConnectionFactory, чтобы создать Соединение JMS. В этой точке запрещается доставка сообщений
• Используйте Соединение, чтобы создать один или более Сеансов JMS
• Используйте Сеанс и Места назначения, чтобы создать MessageProducers и необходимый MessageConsumers
• Запустите доставку сообщений для Соединения. Сообщения будут переданы к MessageConsumers

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

Спецификация пакета

Спецификация Службы сообщения Java - Версия 1.1

Связанная Документация

Учебное руководство по Службе сообщения Java