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

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*. По возврату менеджер ресурсов откатывал работу ответвления и высвободил все сохраненные средства.