Класс 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

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

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

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

forEach, spliterator

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

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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.sql/java/sql/SQLException.html