Класс 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​(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 - Карта, содержащая значения свойств, которые не удалось установить. Ключи в карте содержат имена свойств клиентской информации, которые не удалось установить, а значения содержат один из кодов причины, определённых в 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, 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.
https://docs.oracle.com/en/java/javase/11/docs/api/java.sql/java/sql/SQLClientInfoException.html

Spec-Zone .ru
спецификации, руководства, описания, API