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

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

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

Соединение

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

XAQueueConnection

public interface QueueConnection
расширяет Соединение

A QueueConnection объект является активным соединением с провайдером JMS "точка-точка". Клиент использует a QueueConnection объект создать один или больше QueueSession объекты для создания и потребления сообщений.

A QueueConnection может использоваться, чтобы создать a QueueSession, от которого специализировался могут быть созданы, связанные с очередью объекты. Более общее, и рекомендуемый, подход должен использовать Connection объект.

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

A QueueConnection не может использоваться, чтобы создать объекты, определенные для публиковать/подписываться домена. createDurableConnectionConsumer метод наследовался от Connection, но должен бросить IllegalStateException если использующийся от QueueConnection.

См. Также:

Connection, ConnectionFactory, QueueConnectionFactory

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

ConnectionConsumer	createConnectionConsumer(Queue queue, java.lang.String messageSelector, ServerSessionPool sessionPool, int maxMessages) Создает потребителя соединения для этого соединения (дополнительная работа).
QueueSession	createQueueSession(boolean transacted, int acknowledgeMode) Создает a QueueSession объект.

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

close, createConnectionConsumer, createDurableConnectionConsumer, createSession, getClientID, getExceptionListener, getMetaData, setClientID, setExceptionListener, start, stop

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

createQueueSession

QueueSession createQueueSession(boolean transacted,
                                int acknowledgeMode)
                                throws JMSException

Создает a QueueSession объект.

Параметры:

transacted - указывает, проводится ли сеанс

acknowledgeMode - указывает, подтвердят ли потребитель или клиент какие-либо сообщения, которые это получает; проигнорированный, если сеанс проводится. Юридические значения Session.AUTO_ACKNOWLEDGE, Session.CLIENT_ACKNOWLEDGE, и Session.DUPS_OK_ACKNOWLEDGE.

Возвраты:

недавно создаваемый сеанс очереди

Броски:

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

См. Также:

Session#AUTO_ACKNOWLEDGE, Session#CLIENT_ACKNOWLEDGE, Session#DUPS_OK_ACKNOWLEDGE

createConnectionConsumer

ConnectionConsumer createConnectionConsumer(Queue queue,
                                            java.lang.String messageSelector,
                                            ServerSessionPool sessionPool,
                                            int maxMessages)
                                            throws JMSException

Создает потребителя соединения для этого соединения (дополнительная работа). Это - опытное средство, не используемое регулярными клиентами JMS.

Параметры:

queue - очередь к доступу

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

sessionPool - сеанс сервера объединяет в пул, чтобы связаться с этим потребителем соединения

maxMessages - максимальное количество сообщений, которые могут быть присвоены сеансу сервера когда-то

Возвраты:

потребитель соединения

Броски:

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

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

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

См. Также:

ConnectionConsumer