Класс 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 драйвера позволяет узнать, возвращает ли драйвер тип 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(java.sql.SQLException)

setNextException

public void setNextException(SQLException ex)

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

Параметры:

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

См. также:

getNextException()

iterator

public Iterator<Throwable> iterator()

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

Определено в:: iterator в интерфейсе Iterable<Throwable>
Возвращает:: итератор по цепочке SQLException и причинам в правильном порядке
С:: 1.6

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