javax.resource.spi
Интерфейс XATerminator


public interface XATerminator

Интерфейс XATerminator используется для завершения транзакции и потоков восстановления катастрофического отказа.

Версия:
1.0
Автор:
Поршень Jeyaraman

Сводка метода
 void commit(Xid xid, boolean onePhase)
          Фиксирует глобальную транзакцию, определенную xid.
 void forget(Xid xid)
          Говорит менеджеру ресурсов забывать об эвристическим образом завершенном ответвлении транзакции.
 int prepare(Xid xid)
          Попросите, чтобы менеджер ресурсов подготовился к фиксации транзакции транзакции, определенной в xid.
 Xid[] recover(int flag)
          Получает список готовых ответвлений транзакции от менеджера ресурсов.
 void rollback(Xid xid)
          Сообщает менеджеру ресурсов, чтобы откатывать работу, сделанную от имени ответвления транзакции.
 

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

фиксация

void commit(Xid xid,
            boolean onePhase)
            throws XAException
Фиксирует глобальную транзакцию, определенную xid.

Параметры:
xid - Глобальный идентификатор транзакции
onePhase - Если это правда, менеджер ресурсов должен использовать однофазный протокол фиксации, чтобы фиксировать работу, сделанную от имени xid.
Броски:
XAException - Ошибка произошла. Возможные XAExceptions являются XA_HEURHAZ, XA_HEURCOM, XA_HEURRB, XA_HEURMIX, XAER_RMERR, XAER_RMFAIL, XAER_NOTA, XAER_INVAL, или XAER_PROTO.

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


забыть

void forget(Xid xid)
            throws XAException
Говорит менеджеру ресурсов забывать об эвристическим образом завершенном ответвлении транзакции.

Параметры:
xid - Глобальный идентификатор транзакции.
Броски:
XAException - Ошибка произошла. Возможные значения исключения являются XAER_RMERR, XAER_RMFAIL, XAER_NOTA, XAER_INVAL, или XAER_PROTO.

подготовиться

int prepare(Xid xid)
            throws XAException
Попросите, чтобы менеджер ресурсов подготовился к фиксации транзакции транзакции, определенной в xid.

Параметры:
xid - Глобальный идентификатор транзакции.
Возвраты:
Значение, указывающее на голос менеджера ресурсов по результату транзакции. Возможные значения: XA_RDONLY или XA_OK. Эти константы определяются в javax.transaction.xa.XAResource интерфейс. Если менеджер ресурсов хочет откатывать транзакцию, он должен сделать так, повышая соответствующий XAException в подготовить методе.
Броски:
XAException - Ошибка произошла. Возможные значения исключения: XA_RB *, XAER_RMERR, XAER_RMFAIL, XAER_NOTA, XAER_INVAL, или XAER_PROTO.

восстановиться

Xid[] recover(int flag)
              throws XAException
Получает список готовых ответвлений транзакции от менеджера ресурсов. Менеджер транзакций вызывает этот метод во время восстановления, чтобы получить список ответвлений транзакции, которые находятся в настоящий момент в готовых или эвристическим образом завершенных состояниях.

Параметры:
flag - Один из TMSTARTRSCAN, TMENDRSCAN, TMNOFLAGS. TMNOFLAGS должен использоваться, когда никакие другие флаги не устанавливаются в параметре. Эти константы определяются в javax.transaction.xa.XAResource интерфейс.
Возвраты:
Менеджер ресурсов возвращает нуль или больше XIDs ответвлений транзакции, которые находятся в настоящий момент в готовом или эвристическим образом завершенном состоянии. Если ошибка происходит во время работы, менеджер ресурсов должен бросить соответствующий XAException.
Броски:
XAException - Ошибка произошла. Возможные значения являются XAER_RMERR, XAER_RMFAIL, XAER_INVAL, и XAER_PROTO.

откат

void rollback(Xid xid)
              throws XAException
Сообщает менеджеру ресурсов, чтобы откатывать работу, сделанную от имени ответвления транзакции.

Параметры:
xid - Глобальный идентификатор транзакции.
Броски:
XAException - Ошибка произошла. Возможные XAExceptions являются XA_HEURHAZ, XA_HEURCOM, XA_HEURRB, XA_HEURMIX, XAER_RMERR, XAER_RMFAIL, XAER_NOTA, XAER_INVAL, или XAER_PROTO.

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



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

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

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


Spec-Zone.ru - all specs in one place



free hit counter