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

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

public interface UserTransaction

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

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

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

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

начать

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 - Брошенный, если менеджер транзакций встречается с неожиданным состоянием ошибки.

откат

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

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

Броски:

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

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

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

setRollbackOnly

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

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

Броски:

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

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

getStatus

int getStatus()
              throws SystemException

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

Возвраты:

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

Броски:

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

setTransactionTimeout

void setTransactionTimeout(int seconds)
                           throws SystemException

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

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

Параметры:

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

Броски:

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