Класс SQLRecoverableException

java.sql.SQLRecoverableException

Все реализуемые интерфейсы:: Serializable, Iterable<Throwable>

public class SQLRecoverableException extends SQLException

Подкласс SQLException, который выбрасывается в ситуациях, когда ранее неудачная операция может завершиться успешно, если приложение выполнит некоторые шаги по восстановлению и повторит всю транзакцию или, в случае распределённой транзакции, ветвь транзакции. Как минимум, операция восстановления должна включать закрытие текущего соединения и получение нового соединения.

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

1.6

См. также:

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

Конструктор	Описание
`SQLRecoverableException()`	Создаёт объект `SQLRecoverableException`.
`SQLRecoverableException(String reason)`	Создаёт объект `SQLRecoverableException` с указанным `reason`.
`SQLRecoverableException(String reason, String SQLState)`	Создаёт объект `SQLRecoverableException` с указанными `reason` и `SQLState`.
`SQLRecoverableException(String reason, String SQLState, int vendorCode)`	Создаёт объект `SQLRecoverableException` с указанными `reason`, `SQLState` и `vendorCode`.
`SQLRecoverableException(String reason, String SQLState, int vendorCode, Throwable cause)`	Создаёт объект `SQLRecoverableException` с указанными `reason`, `SQLState`, `vendorCode` и `cause`.
`SQLRecoverableException(String reason, String SQLState, Throwable cause)`	Создаёт объект `SQLRecoverableException` с указанными `reason`, `SQLState` и `cause`.
`SQLRecoverableException(String reason, Throwable cause)`	Создаёт объект `SQLRecoverableException` с указанными `reason` и `cause`.
`SQLRecoverableException(Throwable cause)`	Создаёт объект `SQLRecoverableException` с указанным `cause`.

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

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

getErrorCode, getNextException, getSQLState, iterator, setNextException

Модификатор и тип	Метод	Описание
`int`	`getErrorCode()`	Возвращает специфичный для поставщика код исключения для этого объекта `SQLException`.
`SQLException`	`getNextException()`	Возвращает исключение, связанное с этим объектом `SQLException` методом setNextException(SQLException ex).
`String`	`getSQLState()`	Возвращает SQLState для этого объекта `SQLException`.
`Iterator<Throwable>`	`iterator()`	Возвращает итератор по связанным объектам SQLException.
`void`	`setNextException(SQLException ex)`	Добавляет объект `SQLException` в конец цепочки.

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

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

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

Методы, объявленные в классе 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, либо до истечения заданного промежутка реального времени.

Методы, объявленные в интерфейсе Iterable

forEach, spliterator

Модификатор и тип	Метод	Описание
`default void`	`forEach(Consumer<? super Throwable> action)`	Выполняет указанное действие для каждого элемента `Iterable`, пока не будут обработаны все элементы или действие не выбросит исключение.
`default Spliterator<Throwable>`	`spliterator()`	Создаёт `Spliterator` для элементов, описываемых этим `Iterable`.

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

SQLRecoverableException

public SQLRecoverableException()

Создаёт объект SQLRecoverableException. Значения reason, SQLState инициализируются значением null, а код поставщика — значением 0. Значение cause не инициализируется и может быть инициализировано позднее вызовом метода Throwable.initCause(java.lang.Throwable).

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

SQLRecoverableException

public SQLRecoverableException(String reason)

Создаёт объект SQLRecoverableException с указанным reason. Значение SQLState инициализируется значением null, а код поставщика — значением 0. Значение cause не инициализируется и может быть инициализировано позднее вызовом метода Throwable.initCause(java.lang.Throwable).

Параметры:: reason - описание исключения
Начиная с версии:: 1.6

SQLRecoverableException

public SQLRecoverableException(String reason, String SQLState)

Создаёт объект SQLRecoverableException с указанными reason и SQLState. Значение cause не инициализируется и может быть инициализировано позднее вызовом метода Throwable.initCause(java.lang.Throwable). Код поставщика инициализируется значением 0.

Параметры:: reason - описание исключения; SQLState - код XOPEN или SQL:2003, идентифицирующий исключение
Начиная с версии:: 1.6

SQLRecoverableException

public SQLRecoverableException(String reason, String SQLState, int vendorCode)

Создаёт объект SQLRecoverableException с указанными reason, SQLState и vendorCode. Значение cause не инициализируется и может быть инициализировано позднее вызовом метода Throwable.initCause(java.lang.Throwable).

Параметры:: reason - описание исключения; SQLState - код XOPEN или SQL:2003, идентифицирующий исключение; vendorCode - специфичный для поставщика базы данных код исключения
Начиная с версии:: 1.6

SQLRecoverableException

public SQLRecoverableException(Throwable cause)

Создаёт объект SQLRecoverableException с указанным cause. Значение SQLState инициализируется значением null, а код поставщика — значением 0. Значение reason инициализируется значением null, если cause==null, или значением cause.toString(), если cause!=null.

Параметры:: cause - основная причина этого SQLException (сохраняется для последующего получения методом getCause()); может иметь значение null, указывающее на отсутствие или неизвестность причины.
Начиная с версии:: 1.6

SQLRecoverableException

public SQLRecoverableException(String reason, Throwable cause)

Создаёт объект SQLRecoverableException с указанными reason и cause. Значение SQLState инициализируется значением null, а код поставщика — значением 0.

Параметры:: reason - описание исключения.; cause - основная причина этого SQLException (сохраняется для последующего получения методом getCause()); может иметь значение null, указывающее на отсутствие или неизвестность причины.
Начиная с версии:: 1.6

SQLRecoverableException

public SQLRecoverableException(String reason, String SQLState, Throwable cause)

Создаёт объект SQLRecoverableException с указанными reason, SQLState и cause. Код поставщика инициализируется значением 0.

Параметры:: reason - описание исключения.; SQLState - код XOPEN или SQL:2003, идентифицирующий исключение; cause - основная причина этого SQLException (сохраняется для последующего получения методом getCause()); может иметь значение null, указывающее на отсутствие или неизвестность причины.
Начиная с версии:: 1.6

SQLRecoverableException

public SQLRecoverableException(String reason, String SQLState, int vendorCode, Throwable cause)

Создаёт объект SQLRecoverableException с указанными reason, SQLState, vendorCode и cause.

Параметры:: reason - описание исключения; SQLState - код XOPEN или SQL:2003, идентифицирующий исключение; vendorCode - специфичный для поставщика базы данных код исключения; cause - основная причина этого SQLException (сохраняется для последующего получения методом getCause()); может иметь значение null, указывающее на отсутствие или неизвестность причины.
Начиная с версии:: 1.6

© 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.