Класс SQLClientInfoException

java.sql.SQLClientInfoException

Все реализованные интерфейсы:: Serializable, Iterable<Throwable>

public class SQLClientInfoException extends SQLException

Подкласс SQLException, выбрасываемый, когда одно или несколько свойств клиентской информации не могут быть установлены для Connection. В дополнение к информации, предоставляемой SQLException, класс SQLClientInfoException предоставляет список свойств клиентской информации, которые не были установлены. Некоторые базы данных не позволяют устанавливать несколько свойств клиентской информации атомарно. Для таких баз данных возможно, что некоторые свойства клиентской информации были установлены, несмотря на то, что метод Connection.setClientInfo выбросил исключение. Приложение может использовать метод getFailedProperties для получения списка свойств клиентской информации, которые не были установлены. Свойства идентифицируются путем передачи Map<String,ClientInfoStatus> соответствующему конструктору SQLClientInfoException.

С момента:

1.6

См. также:

Краткое описание конструкторов

Конструктор	Описание
`SQLClientInfoException()`	Создаёт объект `SQLClientInfoException`.
`SQLClientInfoException(String reason, String SQLState, int vendorCode, Map<String,ClientInfoStatus> failedProperties)`	Создаёт объект `SQLClientInfoException`, инициализированный заданным `reason`, `SQLState`, `vendorCode` и `failedProperties`.
`SQLClientInfoException(String reason, String SQLState, int vendorCode, Map<String,ClientInfoStatus> failedProperties, Throwable cause)`	Создаёт объект `SQLClientInfoException`, инициализированный заданным `reason`, `SQLState`, `cause`, `vendorCode` и `failedProperties`.
`SQLClientInfoException(String reason, String SQLState, Map<String,ClientInfoStatus> failedProperties)`	Создаёт объект `SQLClientInfoException`, инициализированный заданным `reason`, `SQLState` и `failedProperties`.
`SQLClientInfoException(String reason, String SQLState, Map<String,ClientInfoStatus> failedProperties, Throwable cause)`	Создаёт объект `SQLClientInfoException`, инициализированный заданным `reason`, `SQLState`, `cause` и `failedProperties`.
`SQLClientInfoException(String reason, Map<String,ClientInfoStatus> failedProperties)`	Создаёт объект `SQLClientInfoException`, инициализированный заданным `reason` и `failedProperties`.
`SQLClientInfoException(String reason, Map<String,ClientInfoStatus> failedProperties, Throwable cause)`	Создаёт объект `SQLClientInfoException`, инициализированный заданным `reason`, `cause` и `failedProperties`.
`SQLClientInfoException(Map<String,ClientInfoStatus> failedProperties)`	Создаёт объект `SQLClientInfoException`, инициализированный заданным `failedProperties`.
`SQLClientInfoException(Map<String,ClientInfoStatus> failedProperties, Throwable cause)`	Создаёт объект `SQLClientInfoException`, инициализированный заданным `cause` и `failedProperties`.

Краткое описание методов

Модификатор и тип	Метод	Описание
`Map<String,ClientInfoStatus>`	`getFailedProperties()`	Возвращает список свойств информации о клиенте, которые не удалось установить.

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

getErrorCode, getNextException, getSQLState, iterator, setNextException

Методы, объявленные в классе 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

Подробное описание конструкторов

SQLClientInfoException

public SQLClientInfoException()

Создаёт объект SQLClientInfoException. Список reason, SQLState и failedProperties инициализируется значениями null, а код поставщика инициализируется значением 0. Поле cause не инициализируется и может быть инициализировано позднее вызовом метода Throwable.initCause(java.lang.Throwable).

Since:: 1.6

SQLClientInfoException

public SQLClientInfoException(Map<String,ClientInfoStatus> failedProperties)

Создаёт объект SQLClientInfoException, инициализированный заданным failedProperties. Поля reason и SQLState инициализируются значениями null, а код поставщика инициализируется значением 0. Поле cause не инициализируется и может быть инициализировано позднее вызовом метода Throwable.initCause(java.lang.Throwable) метода.

Parameters:: failedProperties - Отображение, содержащее значения свойств, которые не удалось установить. Ключи отображения содержат имена свойств клиентской информации, которые не удалось установить, а значения содержат один из кодов причин, определённых в ClientInfoStatus
Since:: 1.6

SQLClientInfoException

public SQLClientInfoException(Map<String,ClientInfoStatus> failedProperties, Throwable cause)

Создаёт объект SQLClientInfoException, инициализированный заданным cause и failedProperties. Поле reason инициализируется значением null, если cause==null, или значением cause.toString(), если cause!=null, а код поставщика инициализируется значением 0.

Parameters:: failedProperties - Отображение, содержащее значения свойств, которые не удалось установить. Ключи отображения содержат имена свойств клиентской информации, которые не удалось установить, а значения содержат один из кодов причин, определённых в ClientInfoStatus; cause - причина (которая сохраняется для последующего извлечения методом getCause()); может быть null, указывая, что причина отсутствует или неизвестна.
Since:: 1.6

SQLClientInfoException

public SQLClientInfoException(String reason, Map<String,ClientInfoStatus> failedProperties)

Создаёт объект SQLClientInfoException, инициализированный заданным reason и failedProperties. Поле SQLState инициализируется значением null, а код поставщика инициализируется значением 0. Поле cause не инициализируется и может быть инициализировано позднее вызовом метода Throwable.initCause(java.lang.Throwable).

Parameters:: reason - описание исключения; failedProperties - Отображение, содержащее значения свойств, которые не удалось установить. Ключи отображения содержат имена свойств клиентской информации, которые не удалось установить, а значения содержат один из кодов причин, определённых в ClientInfoStatus
Since:: 1.6

SQLClientInfoException

public SQLClientInfoException(String reason, Map<String,ClientInfoStatus> failedProperties, Throwable cause)

Создаёт объект SQLClientInfoException, инициализированный заданным reason, cause и failedProperties. Поле SQLState инициализируется значением null, а код поставщика инициализируется значением 0.

Parameters:: reason - описание исключения; failedProperties - Отображение, содержащее значения свойств, которые не удалось установить. Ключи отображения содержат имена свойств клиентской информации, которые не удалось установить, а значения содержат один из кодов причин, определённых в ClientInfoStatus; cause - причина этого SQLException (которая сохраняется для последующего извлечения методом getCause()); может быть null, указывая, что причина отсутствует или неизвестна.
Since:: 1.6

SQLClientInfoException

public SQLClientInfoException(String reason, String SQLState, Map<String,ClientInfoStatus> failedProperties)

Создаёт объект SQLClientInfoException , инициализированный заданным reason, SQLState и failedProperties. Поле cause не инициализировано и может быть инициализировано позднее вызовом метода Throwable.initCause(java.lang.Throwable). Код поставщика инициализирован значением 0.

Parameters:: reason - описание исключения; SQLState - код XOPEN или SQL:2003, идентифицирующий исключение; failedProperties - A Map, содержащий значения свойств, которые не удалось установить. Ключи в Map содержат имена свойств клиентской информации, которые не удалось установить, а значения содержат один из кодов причины, определённых в ClientInfoStatus
Since:: 1.6

SQLClientInfoException

public SQLClientInfoException(String reason, String SQLState, Map<String,ClientInfoStatus> failedProperties, Throwable cause)

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

Parameters:: reason - описание исключения; SQLState - код XOPEN или SQL:2003, идентифицирующий исключение; failedProperties - A Map, содержащий значения свойств, которые не удалось установить. Ключи в Map содержат имена свойств клиентской информации, которые не удалось установить, а значения содержат один из кодов причины, определённых в ClientInfoStatus; cause - причина этого SQLException (сохраняется для последующего извлечения методом getCause()); может быть null, указывая на отсутствие или неизвестность причины.
Since:: 1.6

SQLClientInfoException

public SQLClientInfoException(String reason, String SQLState, int vendorCode, Map<String,ClientInfoStatus> failedProperties)

Создаёт объект SQLClientInfoException , инициализированный заданным reason, SQLState, vendorCode и failedProperties. Поле cause не инициализировано и может быть инициализировано позднее вызовом метода Throwable.initCause(java.lang.Throwable) метода.

Parameters:: reason - описание исключения; SQLState - код XOPEN или SQL:2003, идентифицирующий исключение; vendorCode - код исключения, специфичный для поставщика базы данных; failedProperties - A Map, содержащий значения свойств, которые не удалось установить. Ключи в Map содержат имена свойств клиентской информации, которые не удалось установить, а значения содержат один из кодов причины, определённых в ClientInfoStatus
Since:: 1.6

SQLClientInfoException

public SQLClientInfoException(String reason, String SQLState, int vendorCode, Map<String,ClientInfoStatus> failedProperties, Throwable cause)

Создаёт объект SQLClientInfoException , инициализированный заданным reason, SQLState, cause, vendorCode и failedProperties.

Parameters:: reason - описание исключения; SQLState - код XOPEN или SQL:2003, идентифицирующий исключение; vendorCode - код исключения, специфичный для поставщика базы данных; failedProperties - A Map, содержащий значения свойств, которые не удалось установить. Ключи в Map содержат имена свойств клиентской информации, которые не удалось установить, а значения содержат один из кодов причины, определённых в ClientInfoStatus; cause - причина этого SQLException (сохраняется для последующего извлечения методом getCause()); может быть null, указывая на отсутствие или неизвестность причины.
Since:: 1.6

Методы

getFailedProperties

public Map<String,ClientInfoStatus> getFailedProperties()

Возвращает список свойств клиентской информации, которые не удалось установить. Ключи в Map содержат имена свойств клиентской информации, которые не удалось установить, а значения содержат один из кодов причины, определённых в ClientInfoStatus

Returns:: Список Map, содержащий свойства клиентской информации, которые не удалось установить
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/SQLClientInfoException.html