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

Методы

getFailedProperties

public Map<String,ClientInfoStatus> getFailedProperties()

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

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