Класс 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()`	Возвращает список свойств информации о клиенте, которые не удалось задать.

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

getErrorCode, getNextException, getSQLState, iterator, setNextException

Методы, объявленные в классе Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Методы, объявленные в интерфейсе 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.

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

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

getFailedProperties

public Map<String, ClientInfoStatus> getFailedProperties()

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

Возвращает:: Список свойств информации о клиенте, которые не удалось задать, в виде карты
С момента:: 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://docs.oracle.com/en/java/javase/25/docs/api/java.sql/java/sql/SQLClientInfoException.html