Класс 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(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.
https://docs.oracle.com/en/java/javase/11/docs/api/java.sql/java/sql/SQLException.html

Spec-Zone .ru
спецификации, руководства, описания, API