Класс 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

Модификатор и тип	Метод	Описание
`int`	`getErrorCode()`	Получает код исключения, специфичный для поставщика, для объекта `SQLException`.
`SQLException`	`getNextException()`	Получает исключение, связанное с этим объектом `SQLException` методом setNextException(SQLException ex).
`String`	`getSQLState()`	Получает SQLState для этого объекта `SQLException`.
`Iterator<Throwable>`	`iterator()`	Возвращает итератор по цепочке объектов SQLException.
`void`	`setNextException(SQLException ex)`	Добавляет объект `SQLException` в конец цепочки.

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

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

Модификатор и тип	Метод	Описание
`final void`	`addSuppressed(Throwable exception)`	Добавляет указанное исключение к исключениям, подавленным для передачи этого исключения.
`Throwable`	`fillInStackTrace()`	Заполняет трассировку стека выполнения.
`Throwable`	`getCause()`	Возвращает причину возникновения этого исключения или `null`, если причина отсутствует или неизвестна.
`String`	`getLocalizedMessage()`	Создает локализованное описание этого исключения.
`String`	`getMessage()`	Возвращает строку с подробным сообщением этого исключения.
`StackTraceElement[]`	`getStackTrace()`	Предоставляет программный доступ к сведениям о трассировке стека, выводимым методом `Throwable.printStackTrace()`.
`final Throwable[]`	`getSuppressed()`	Возвращает массив, содержащий все исключения, подавленные, как правило, оператором `try`-with-resources, для передачи этого исключения.
`Throwable`	`initCause(Throwable cause)`	Инициализирует причину этого исключения указанным значением.
`void`	`printStackTrace()`	Выводит это исключение и его трассировку в стандартный поток ошибок.
`void`	`printStackTrace(PrintStream s)`	Выводит это исключение и его трассировку в указанный поток вывода.
`void`	`printStackTrace(PrintWriter s)`	Выводит это исключение и его трассировку в указанный объект PrintWriter.
`void`	`setStackTrace(StackTraceElement[] stackTrace)`	Задает элементы трассировки стека, которые будут возвращены методом `Throwable.getStackTrace()` и выведены методом `Throwable.printStackTrace()` и связанными методами.
`String`	`toString()`	Возвращает краткое описание этого исключения.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли этот объект другому объекту.
`protected void`	`finalize()`	Устарело и подлежит удалению: этот элемент API может быть удален в одной из будущих версий. Финализация объявлена устаревшей и подлежит удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает значение хеш-кода для этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Приостанавливает текущий поток до его пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Приостанавливает текущий поток до его пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного интервала реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Приостанавливает текущий поток до его пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного интервала реального времени.

Методы, объявленные в интерфейсе Iterable

forEach, spliterator

Модификатор и тип	Метод	Описание
`default void`	`forEach(Consumer<? super Throwable> action)`	Выполняет указанное действие для каждого элемента `Iterable`, пока не будут обработаны все элементы или действие не вызовет исключение.
`default Spliterator<Throwable>`	`spliterator()`	Создает `Spliterator` для элементов, описываемых этим `Iterable`.

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

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 — карта, содержащая значения свойств, которые не удалось задать. Ключи карты содержат имена свойств клиентской информации, которые не удалось задать, а значения — один из кодов причин, определенных в 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

Возвращает:: список 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.