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


Представьте ошибку или функцию

Авторское право © 2009-2011, Oracle Corporation и/или его филиалы. Все права защищены. Использование подвергается срокам действия лицензии.

Сгенерированный на 10-February-2011 12:41

free hit counter