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


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

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

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

free hit counter