Класс SQLClientInfoException

java.sql.SQLClientInfoException

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

public class SQLClientInfoException extends SQLException

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

Since:

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).

С момента:: 1.6

SQLClientInfoException

public SQLClientInfoException(Map<String, ClientInfoStatus> failedProperties)

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

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

SQLClientInfoException

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

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

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

SQLClientInfoException

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

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

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

SQLClientInfoException

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

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

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

SQLClientInfoException

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

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

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

SQLClientInfoException

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

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

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

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

SQLClientInfoException

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

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

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

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

getFailedProperties

public Map<String, ClientInfoStatus> getFailedProperties()

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

Возвращает:: Список Map, содержащий свойства клиентской информации, которые не удалось установить
С:: 1.6

© 1993, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/java.sql/java/sql/SQLClientInfoException.html