Класс 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 Exception и доступна через метод getMessage.
строка "SQLstate", которая следует либо соглашениям XOPEN SQLstate, либо соглашениям SQL:2003. Значения строки SQLState описаны в соответствующих спецификациях. Метод DatabaseMetaData драйвера можно использовать для определения, возвращает ли драйвер тип 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, что указывает на отсутствие или неизвестность причины.
Since:: 1.6

SQLException

public SQLException(String reason, Throwable cause)

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

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

© 1993, 2023, 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/21/docs/api/java.sql/java/sql/SQLException.html