Класс XAException

javax.transaction.xa.XAException

Все реализуемые интерфейсы:: Serializable

public class XAException extends Exception

XAException выбрасывается диспетчером ресурсов (RM), чтобы сообщить диспетчеру транзакций об ошибке, возникшей в участвующей транзакции.

Начиная с версии:

1.4

См. также:

Краткое описание полей

Модификатор и тип	Поле	Описание
`int`	`errorCode`	Код ошибки, с которым создаётся SystemException.
`static final int`	`XA_HEURCOM`	Ветвь транзакции эвристически зафиксирована.
`static final int`	`XA_HEURHAZ`	Возможно, ветвь транзакции была эвристически завершена.
`static final int`	`XA_HEURMIX`	Ветвь транзакции эвристически зафиксирована и отменена.
`static final int`	`XA_HEURRB`	Ветвь транзакции эвристически отменена.
`static final int`	`XA_NOMIGRATE`	Возобновление должно происходить там же, где произошло приостановление.
`static final int`	`XA_RBBASE`	Включительная нижняя граница кодов отмены.
`static final int`	`XA_RBCOMMFAIL`	Указывает, что отмена была вызвана сбоем связи.
`static final int`	`XA_RBDEADLOCK`	Обнаружена взаимная блокировка.
`static final int`	`XA_RBEND`	Включительная верхняя граница кода ошибки отмены.
`static final int`	`XA_RBINTEGRITY`	Обнаружено условие, нарушающее целостность ресурса.
`static final int`	`XA_RBOTHER`	Диспетчер ресурсов отменил ветвь транзакции по причине, не указанной в этом списке.
`static final int`	`XA_RBPROTO`	В диспетчере ресурсов произошла ошибка протокола.
`static final int`	`XA_RBROLLBACK`	Указывает, что отмена была вызвана неуказанной причиной.
`static final int`	`XA_RBTIMEOUT`	Обработка ветви транзакции заняла слишком много времени.
`static final int`	`XA_RBTRANSIENT`	Можно повторить попытку обработки ветви транзакции.
`static final int`	`XA_RDONLY`	Ветвь транзакции была доступна только для чтения и зафиксирована.
`static final int`	`XA_RETRY`	Процедура завершилась без эффекта; её можно вызвать повторно.
`static final int`	`XAER_ASYNC`	Уже выполняется асинхронная операция.
`static final int`	`XAER_DUPID`	XID уже существует.
`static final int`	`XAER_INVAL`	Переданы недопустимые аргументы.
`static final int`	`XAER_NOTA`	XID недействителен.
`static final int`	`XAER_OUTSIDE`	Диспетчер ресурсов выполняет работу вне глобальной транзакции.
`static final int`	`XAER_PROTO`	Процедура вызвана в недопустимом контексте.
`static final int`	`XAER_RMERR`	В ветви транзакции произошла ошибка диспетчера ресурсов.
`static final int`	`XAER_RMFAIL`	Диспетчер ресурсов недоступен.

Краткое описание конструкторов

Конструктор	Описание
`XAException()`	Создаёт XAException.
`XAException(int errcode)`	Создаёт XAException с заданным кодом ошибки.
`XAException(String s)`	Создаёт XAException с заданной строкой.

Краткое описание методов

Методы, объявленные в классе Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Модификатор и тип	Метод	Описание
`final void`	`addSuppressed(Throwable exception)`	Добавляет указанное исключение к исключениям, которые были подавлены при создании этого исключения.
`Throwable`	`fillInStackTrace()`	Заполняет трассировку стека вызовов.
`Throwable`	`getCause()`	Возвращает причину этого исключения или `null`, если причина отсутствует или неизвестна.
`String`	`getLocalizedMessage()`	Создаёт локализованное описание этого исключения.
`String`	`getMessage()`	Возвращает строку с подробным сообщением этого исключения.
`StackTraceElement[]`	`getStackTrace()`	Предоставляет программный доступ к сведениям о трассировке стека, выводимым методом `Throwable.printStackTrace()`.
`final Throwable[]`	`getSuppressed()`	Возвращает массив всех исключений, которые были подавлены, обычно инструкцией `try`-with-resources, при создании этого исключения.
`Throwable`	`initCause(Throwable cause)`	Инициализирует причину этого исключения указанным значением.
`void`	`printStackTrace()`	Выводит это исключение и трассировку стека в стандартный поток ошибок.
`void`	`printStackTrace(PrintStream s)`	Выводит это исключение и трассировку стека в указанный поток печати.
`void`	`printStackTrace(PrintWriter s)`	Выводит это исключение и трассировку стека в указанный объект PrintWriter.
`void`	`setStackTrace(StackTraceElement[] stackTrace)`	Задаёт элементы трассировки стека, которые будут возвращены методом `Throwable.getStackTrace()` и выведены методом `Throwable.printStackTrace()` и связанными с ним методами.
`String`	`toString()`	Возвращает краткое описание этого исключения.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Определяет, «равен ли» этот объект другому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Метод финализации устарел и подлежит удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого объекта `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ждать пробуждения, обычно вследствие вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ждать пробуждения, обычно вследствие вызова notify или interrupt, либо до истечения указанного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ждать пробуждения, обычно вследствие вызова notify или interrupt, либо до истечения указанного промежутка реального времени.

Подробное описание полей

errorCode

public int errorCode

Код ошибки, с которым создаётся SystemException.

XA_RBBASE

public static final int XA_RBBASE

Включительная нижняя граница кодов отмены.

См. также:

XA_RBROLLBACK

public static final int XA_RBROLLBACK

Указывает, что отмена была вызвана неуказанной причиной.

См. также:

XA_RBCOMMFAIL

public static final int XA_RBCOMMFAIL

Указывает, что отмена была вызвана сбоем связи.

См. также:

XA_RBDEADLOCK

public static final int XA_RBDEADLOCK

Обнаружена взаимная блокировка.

См. также:

XA_RBINTEGRITY

public static final int XA_RBINTEGRITY

Обнаружено условие, нарушающее целостность ресурса.

См. также:

XA_RBOTHER

public static final int XA_RBOTHER

Диспетчер ресурсов отменил ветвь транзакции по причине, не указанной в этом списке.

См. также:

XA_RBPROTO

public static final int XA_RBPROTO

В диспетчере ресурсов произошла ошибка протокола.

См. также:

XA_RBTIMEOUT

public static final int XA_RBTIMEOUT

Обработка ветви транзакции заняла слишком много времени.

См. также:

XA_RBTRANSIENT

public static final int XA_RBTRANSIENT

Можно повторить попытку обработки ветви транзакции.

См. также:

XA_RBEND

public static final int XA_RBEND

Включительная верхняя граница кода ошибки отмены.

См. также:

XA_NOMIGRATE

public static final int XA_NOMIGRATE

Возобновление должно происходить там же, где произошло приостановление.

См. также:

XA_HEURHAZ

public static final int XA_HEURHAZ

Возможно, ветвь транзакции была эвристически завершена.

См. также:

XA_HEURCOM

public static final int XA_HEURCOM

Ветвь транзакции эвристически зафиксирована.

См. также:

XA_HEURRB

public static final int XA_HEURRB

Ветвь транзакции эвристически отменена.

См. также:

XA_HEURMIX

public static final int XA_HEURMIX

Ветвь транзакции эвристически зафиксирована и отменена.

См. также:

XA_RETRY

public static final int XA_RETRY

Процедура завершилась без эффекта; её можно вызвать повторно.

См. также:

XA_RDONLY

public static final int XA_RDONLY

Ветвь транзакции была доступна только для чтения и зафиксирована.

См. также:

XAER_ASYNC

public static final int XAER_ASYNC

Уже выполняется асинхронная операция.

См. также:

XAER_RMERR

public static final int XAER_RMERR

В ветви транзакции произошла ошибка диспетчера ресурсов.

См. также:

XAER_NOTA

public static final int XAER_NOTA

XID недействителен.

См. также:

XAER_INVAL

public static final int XAER_INVAL

Переданы недопустимые аргументы.

См. также:

XAER_PROTO

public static final int XAER_PROTO

Процедура вызвана в недопустимом контексте.

См. также:

XAER_RMFAIL

public static final int XAER_RMFAIL

Диспетчер ресурсов недоступен.

См. также:

XAER_DUPID

public static final int XAER_DUPID

XID уже существует.

См. также:

XAER_OUTSIDE

public static final int XAER_OUTSIDE

Диспетчер ресурсов выполняет работу вне глобальной транзакции.

См. также:

Подробное описание конструкторов

XAException

public XAException()

Создаёт XAException.

XAException

public XAException(String s)

Создаёт XAException с заданной строкой.

Параметры:: s — объект String, содержащий сообщение исключения.

XAException

public XAException(int errcode)

Создаёт XAException с заданным кодом ошибки.

Параметры:: errcode — код ошибки, идентифицирующий исключение.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.