Класс SQLException

java.lang.Object
- java.lang.Throwable
- - java.lang.Exception
  - - 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-исключения, доступного через метод getMesasge.
строку "SQLstate", которая следует либо соглашениям XOPEN SQLstate, либо соглашениям SQL:2003. Значения строки SQLState описаны в соответствующем спецификации. Метод DatabaseMetaData getSQLStateType может быть использован для определения того, возвращает ли драйвер тип XOPEN или тип SQL:2003.
целочисленный код ошибки, специфичный для каждого поставщика. Обычно это фактический код ошибки, возвращаемый базой данных.
цепочку к следующему исключению. Это может использоваться для предоставления дополнительной информации об ошибке.
причинно-следственную связь, если она есть для данного SQLException.

См. также:: Формат сериализации

Конструкторы

Конструктор и описание
`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, 2020, 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.