Класс SQLClientInfoException

java.lang.Object
- java.lang.Throwable
- - java.lang.Exception
  - - java.sql.SQLException
    - - java.sql.SQLClientInfoException

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

public class SQLClientInfoException
extends SQLException

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

С момента:: 1.6
См. также:: ClientInfoStatus, Connection.setClientInfo(java.lang.String, java.lang.String), Сериализованная форма

Конструкторы

Конструктор и описание
`SQLClientInfoException()` Создаёт объект `SQLClientInfoException`.
`SQLClientInfoException(Map<String,ClientInfoStatus> failedProperties)` Создаёт объект `SQLClientInfoException` с заданным `failedProperties`.
`SQLClientInfoException(Map<String,ClientInfoStatus> failedProperties, Throwable cause)` Создаёт объект `SQLClientInfoException` с заданным `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(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`.

Методы

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