Класс 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` в конец цепочки.

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

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

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

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

Методы, объявленные в интерфейсе java.lang.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://download.java.net/java/early_access/jdk24/docs/api/java.sql/java/sql/SQLException.html