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

javax.transaction
Транзакция интерфейса

public interface Transaction

Интерфейс Транзакции позволяет операциям выполняться против транзакции в целевом объекте Транзакции. Объект Транзакции создается, соответствуя каждому глобальному созданию транзакции. Объект Транзакции может использоваться для включения в список ресурса, регистрации синхронизации, завершения транзакции, и операций запроса состояния.

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

void	commit() Завершите транзакцию, представленную этим объектом Транзакции.
boolean	delistResource(XAResource xaRes, int flag) Разъедините ресурс, определенный с транзакцией, связанной с целевым объектом Транзакции.
boolean	enlistResource(XAResource xaRes) Включите в список ресурс, определенный с транзакцией, связанной с целевым объектом Транзакции.
int	getStatus() Получите состояние транзакции, связанной с целевым объектом Транзакции.
void	registerSynchronization(Synchronization sync) Зарегистрируйте объект синхронизации для транзакции, в настоящий момент связанной с целевым объектом.
void	rollback() Откатывайте транзакцию, представленную этим объектом Транзакции.
void	setRollbackOnly() Измените транзакцию, связанную с целевым объектом так, что, единственный возможный исход транзакции должен откатывать транзакцию.

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

фиксация

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

Завершите транзакцию, представленную этим объектом Транзакции.

Броски:

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

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

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

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

IllegalStateException - Брошенный, если транзакция в целевом объекте неактивна.

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

delistResource

boolean delistResource(XAResource xaRes,
                       int flag)
                       throws java.lang.IllegalStateException,
                              SystemException

Разъедините ресурс, определенный с транзакцией, связанной с целевым объектом Транзакции.

Параметры:

xaRes - Объект XAResource связался с ресурсом (соединение).

flag - Одно из значений TMSUCCESS, TMSUSPEND, или TMFAIL.

Возвраты:

истина, если ресурс был вычеркнут из списка успешно; иначе ложь.

Броски:

IllegalStateException - Брошенный, если транзакция в целевом объекте неактивна.

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

enlistResource

boolean enlistResource(XAResource xaRes)
                       throws RollbackException,
                              java.lang.IllegalStateException,
                              SystemException

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

Параметры:

xaRes - Объект XAResource связался с ресурсом (соединение).

Возвраты:

истина, если ресурс был включен в список успешно; иначе ложь.

Броски:

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

IllegalStateException - Брошенный, если транзакция в целевом объекте находится в готовом состоянии или транзакции, неактивно.

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

getStatus

int getStatus()
              throws SystemException

Получите состояние транзакции, связанной с целевым объектом Транзакции.

Возвраты:

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

Броски:

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

registerSynchronization

void registerSynchronization(Synchronization sync)
                             throws RollbackException,
                                    java.lang.IllegalStateException,
                                    SystemException

Зарегистрируйте объект синхронизации для транзакции, в настоящий момент связанной с целевым объектом. transction менеджер вызывает beforeCompletion метод до запуска двухфазного процесса фиксации транзакции. После того, как транзакция завершается, менеджер транзакций вызывает afterCompletion метод.

Параметры:

sync - Объект Синхронизации для транзакции связался с целевым объектом.

Броски:

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

IllegalStateException - Брошенный, если транзакция в целевом объекте находится в готовом состоянии или транзакции, неактивно.

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

откат

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

Откатывайте транзакцию, представленную этим объектом Транзакции.

Броски:

IllegalStateException - Брошенный, если транзакция в целевом объекте находится в готовом состоянии или транзакции, неактивно.

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

setRollbackOnly

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

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

Броски:

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

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