Класс SQLException

java.sql.SQLException

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

Прямые известные подклассы:: BatchUpdateException, RowSetWarning, SerialException, SQLClientInfoException, SQLNonTransientException, SQLRecoverableException, SQLTransientException, SQLWarning, SyncFactoryException, SyncProviderException

public class SQLException extends Exception implements Iterable<Throwable>

Исключение, предоставляющее сведения об ошибке доступа к базе данных или других ошибках.

Каждый SQLException предоставляет несколько видов сведений:

строку с описанием ошибки. Она используется в качестве сообщения исключения Java и доступна с помощью метода getMessage.
строку «SQLstate», соответствующую соглашениям XOPEN SQLstate или SQL:2003. Значения строки SQLState описаны в соответствующей спецификации. Метод DatabaseMetaData getSQLStateType позволяет определить, возвращает ли драйвер тип XOPEN или SQL:2003.
целочисленный код ошибки, специфичный для каждого поставщика. Обычно это фактический код ошибки, возвращённый базовой базой данных.
цепочку со следующим исключением. Она может использоваться для предоставления дополнительных сведений об ошибке.
причинно-следственную связь, если она имеется, для этого SQLException.

Начиная с:

1.1

См. также:

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

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

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

Модификатор и тип	Метод	Описание
`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()`	Возвращает причину этого выбрасываемого объекта или `null`, если причина отсутствует или неизвестна.
`String`	`getLocalizedMessage()`	Создаёт локализованное описание этого выбрасываемого объекта.
`String`	`getMessage()`	Возвращает строку подробного сообщения этого выбрасываемого объекта.
`StackTraceElement[]`	`getStackTrace()`	Предоставляет программный доступ к сведениям о трассировке стека, выводимым методом `Throwable.printStackTrace()`.
`final Throwable[]`	`getSuppressed()`	Возвращает массив, содержащий все исключения, которые были подавлены, как правило, оператором `try` с автоматическим закрытием ресурсов, при передаче этого исключения.
`Throwable`	`initCause(Throwable cause)`	Инициализирует причину этого выбрасываемого объекта указанным значением.
`void`	`printStackTrace()`	Выводит этот выбрасываемый объект и его трассировку в стандартный поток ошибок.
`void`	`printStackTrace(PrintStream s)`	Выводит этот выбрасываемый объект и его трассировку в указанный поток печати.
`void`	`printStackTrace(PrintWriter s)`	Выводит этот выбрасываемый объект и его трассировку в указанный объект для печати.
`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()`	Заставляет текущий поток ожидать пробуждения, обычно вследствие уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно вследствие уведомления или прерывания, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно вследствие уведомления или прерывания, либо до истечения заданного промежутка реального времени.

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

forEach, spliterator

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

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

SQLException

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

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

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

SQLException

public SQLException(String reason, String SQLState)

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

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

SQLException

public SQLException(String reason)

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

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

SQLException

public SQLException()

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

SQLException

public SQLException(Throwable cause)

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

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

SQLException

public SQLException(String reason, Throwable cause)

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

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

SQLException

public SQLException(String reason, String sqlState, Throwable cause)

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

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

SQLException

public SQLException(String reason, String sqlState, int vendorCode, Throwable cause)

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

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

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

getSQLState

public String getSQLState()

Возвращает SQLState для этого объекта SQLException.

Возвращает:: значение SQLState

getErrorCode

public int getErrorCode()

Возвращает специфичный для поставщика код исключения для этого объекта SQLException.

Возвращает:: код ошибки поставщика

getNextException

public SQLException getNextException()

Возвращает исключение, связанное с этим объектом SQLException с помощью setNextException(SQLException ex).

Возвращает:

следующий объект SQLException в цепочке; null, если таких объектов нет

См. также:

setNextException

public void setNextException(SQLException ex)

Добавляет объект SQLException в конец цепочки.

Параметры:

ex - новое исключение, которое будет добавлено в конец цепочки SQLException

См. также:

iterator

public Iterator<Throwable> iterator()

Возвращает итератор по цепочке SQLException. Итератор используется для перебора каждого SQLException и его базовой причины (если она есть).

Указано в:: iterator в интерфейсе Iterable<Throwable>
Возвращает:: итератор по цепочке SQLException и причинам в надлежащем порядке
Начиная с:: 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.