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

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

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

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

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

XAQueueSession, XATopicSession

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

XASession интерфейс расширяет возможность Session добавляя доступ к поддержке провайдера JMS API Транзакции Java (дополнительный) (JTA). Эта поддержка принимает форму a javax.transaction.xa.XAResource объект. Функциональность этого объекта близко напоминает что определенный стандартом X/Open XA интерфейс Ресурса.

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

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

Клиенту сервера приложений дают то, что он думает, регулярный JMS Session. Негласно, сервер приложений управляет управлением транзакциями базового XASession.

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

См. Также:

Session

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

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

AUTO_ACKNOWLEDGE, CLIENT_ACKNOWLEDGE, DUPS_OK_ACKNOWLEDGE, SESSION_TRANSACTED

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

void	commit() Броски a TransactionInProgressException, так как это не должно требоваться XASession объект.
Сеанс	getSession() Связали сеанс с этим XASession.
boolean	getTransacted() Указывает, является ли сеанс в транзакционном режиме.
XAResource	getXAResource() Возвращает ресурс XA вызывающей стороне.
void	rollback() Броски a TransactionInProgressException, так как это не должно требоваться XASession объект.

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

close, createBrowser, createBrowser, createBytesMessage, createConsumer, createConsumer, createConsumer, createDurableSubscriber, createDurableSubscriber, createMapMessage, createMessage, createObjectMessage, createObjectMessage, createProducer, createQueue, createStreamMessage, createTemporaryQueue, createTemporaryTopic, createTextMessage, createTextMessage, createTopic, getAcknowledgeMode, getMessageListener, recover, run, setMessageListener, unsubscribe

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

getSession

Session getSession()
                   throws JMSException

Связали сеанс с этим XASession.

Возвраты:

объект сеанса

Броски:

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

С тех пор:

1.1

getXAResource

XAResource getXAResource()

Возвращает ресурс XA вызывающей стороне.

Возвраты:

ресурс XA к вызывающей стороне

getTransacted

boolean getTransacted()
                      throws JMSException

Указывает, является ли сеанс в транзакционном режиме.

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

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

Возвраты:

истина

Броски:

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

фиксация

void commit()
            throws JMSException

Броски a TransactionInProgressException, так как это не должно требоваться XASession объект.

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

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

Броски:

TransactionInProgressException - если к методу обращаются XASession.

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

откат

void rollback()
              throws JMSException

Броски a TransactionInProgressException, так как это не должно требоваться XASession объект.

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

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

Броски:

TransactionInProgressException - если к методу обращаются XASession.

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