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

javax.transaction
Интерфейс TransactionManager

public interface TransactionManager

Интерфейс TransactionManager определяет методы, которые позволяют серверу приложений управлять границами транзакции.

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

void	begin() Создайте новую транзакцию и свяжите ее с текущим потоком.
void	commit() Завершите транзакцию, связанную с текущим потоком.
int	getStatus() Получите состояние транзакции, связанной с текущим потоком.
Транзакция	getTransaction() Получите объект транзакции, который представляет контекст транзакции вызывающего потока.
void	resume(Transaction tobj) Возобновите ассоциацию контекста транзакции вызывающего потока с транзакцией, представленной предоставленным объектом Транзакции.
void	rollback() Откатывайте транзакцию, связанную с текущим потоком.
void	setRollbackOnly() Измените транзакцию, связанную с текущим потоком так, что, единственный возможный исход транзакции должен откатывать транзакцию.
void	setTransactionTimeout(int seconds) Измените значение тайм-аута, которое связывается с транзакциями, запущенными текущим потоком с начать методом.
Транзакция	suspend() Приостановите транзакцию, в настоящий момент связанную с вызывающим потоком, и возвратите объект Транзакции, который представляет приостанавливаемый контекст транзакции.

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

начать

void begin()
           throws NotSupportedException,
                  SystemException

Создайте новую транзакцию и свяжите ее с текущим потоком.

Броски:

NotSupportedException - Брошенный, если поток уже связывается с транзакцией и реализацией Менеджера транзакций, не поддерживает вложенные транзакции.

SystemException - Брошенный, если менеджер транзакций встречается с неожиданным состоянием ошибки.

фиксация

void commit()
            throws RollbackException,
                   HeuristicMixedException,
                   HeuristicRollbackException,
                   java.lang.SecurityException,
                   java.lang.IllegalStateException,
                   SystemException

Завершите транзакцию, связанную с текущим потоком. Когда этот метод завершается, поток больше не связывается с транзакцией.

Броски:

RollbackException - Брошенный, чтобы указать, что транзакция откатывалась, а не фиксировалась.

HeuristicMixedException - Брошенный, чтобы указать, что эвристическое решение было принято и что некоторые соответствующие обновления фиксировались, в то время как другие откатывались.

HeuristicRollbackException - Брошенный, чтобы указать, что эвристическое решение было принято и что откатывались все соответствующие обновления.

SecurityException - Брошенный, чтобы указать, что потоку не позволяют фиксировать транзакцию.

IllegalStateException - Брошенный, если текущий поток не связывается с транзакцией.

SystemException - Брошенный, если менеджер транзакций встречается с неожиданным состоянием ошибки.

getStatus

int getStatus()
              throws SystemException

Получите состояние транзакции, связанной с текущим потоком.

Возвраты:

Состояние транзакции. Если никакая транзакция не связывается с текущим потоком, этот метод возвращает Состояние. Значение NoTransaction.

Броски:

SystemException - Брошенный, если менеджер транзакций встречается с неожиданным состоянием ошибки.

getTransaction

Transaction getTransaction()
                           throws SystemException

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

Возвраты:

Transaction объект, представляющий транзакцию, связался с вызывающим потоком.

Броски:

SystemException - Брошенный, если менеджер транзакций встречается с неожиданным состоянием ошибки.

резюме

void resume(Transaction tobj)
            throws InvalidTransactionException,
                   java.lang.IllegalStateException,
                   SystemException

Возобновите ассоциацию контекста транзакции вызывающего потока с транзакцией, представленной предоставленным объектом Транзакции. Когда этот метод возвращается, вызывающий поток связывается с определенным контекстом транзакции.

Параметры:

tobj - Transaction объект, который представляет транзакцию, которая будет возобновлена.

Броски:

InvalidTransactionException - Брошенный, если объект транзакции параметра содержит недопустимую транзакцию.

IllegalStateException - Брошенный, если поток уже связывается с другой транзакцией.

SystemException - Брошенный, если менеджер транзакций встречается с неожиданным состоянием ошибки.

откат

void rollback()
              throws java.lang.IllegalStateException,
                     java.lang.SecurityException,
                     SystemException

Откатывайте транзакцию, связанную с текущим потоком. Когда этот метод завершается, поток больше не связывается с транзакцией.

Броски:

SecurityException - Брошенный, чтобы указать, что потоку не позволяют откатывать транзакцию.

IllegalStateException - Брошенный, если текущий поток не связывается с транзакцией.

SystemException - Брошенный, если менеджер транзакций встречается с неожиданным состоянием ошибки.

setRollbackOnly

void setRollbackOnly()
                     throws java.lang.IllegalStateException,
                            SystemException

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

Броски:

IllegalStateException - Брошенный, если текущий поток не связывается с транзакцией.

SystemException - Брошенный, если менеджер транзакций встречается с неожиданным состоянием ошибки.

setTransactionTimeout

void setTransactionTimeout(int seconds)
                           throws SystemException

Измените значение тайм-аута, которое связывается с транзакциями, запущенными текущим потоком с начать методом.

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

Параметры:

seconds - Значение тайм-аута в секундах. Если значение является нулем, служба транзакции восстанавливает значение по умолчанию. Если значение отрицательно, SystemException бросается.

Броски:

SystemException - Брошенный, если менеджер транзакций встречается с неожиданным состоянием ошибки.

приостановить

Transaction suspend()
                    throws SystemException

Приостановите транзакцию, в настоящий момент связанную с вызывающим потоком, и возвратите объект Транзакции, который представляет приостанавливаемый контекст транзакции. Если вызывающий поток не связывается с транзакцией, метод возвращает нулевую ссылку на объект. Когда этот метод возвращается, вызывающий поток не связывается с транзакцией.

Возвраты:

Объект транзакции представление приостановленной транзакции.

Броски:

SystemException - Брошенный, если менеджер транзакций встречается с неожиданным состоянием ошибки.