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

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

Есть два типа 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 для получения дополнительной информации.

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

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

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

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

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

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

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

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

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

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

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

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

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



Представьте ошибку или функцию

Авторское право © 2009-2011, Oracle Corporation и/или его филиалы. Все права защищены. Использование подвергается срокам действия лицензии.

Сгенерированный на 10-February-2011 12:41


Spec-Zone.ru - all specs in one place



free hit counter