compact2, compact3

java.sql

Class SQLClientInfoException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.sql.SQLException

java.sql.SQLClientInfoException

All Implemented Interfaces:

Serializable Iterable Throwable >，<

public class SQLClientInfoException
extends SQLException

子类的 SQLException时引发一个或多个客户信息属性无法设置在 Connection。除了提供 SQLException信息，一 SQLClientInfoException提供客户名单信息属性未设置。一些数据库不允许多个客户端信息属性进行设置自动。对于那些数据库，它可能是一些客户信息的性质已经确定即使 Connection.setClientInfo方法抛出一个异常。应用程序可以使用 getFailedProperties 方法检索客户名单信息属性未设置。性能是通过 Map<String,ClientInfoStatus>到适当的 SQLClientInfoException构造函数确定。

从以下版本开始：

一点六

另请参见：

ClientInfoStatus， Connection.setClientInfo(java.lang.String, java.lang.String)， Serialized Form

构造方法摘要

构造方法

Constructor and Description
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。

方法摘要

Modifier and Type	Method and Description
Map<String,ClientInfoStatus>	getFailedProperties() 返回无法设置的客户端信息属性的列表。

Methods inherited from class java.sql.SQLException

getErrorCode, getNextException, getSQLState, iterator, setNextException

Methods inherited from class java.lang.Throwable

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

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

SQLClientInfoException

public SQLClientInfoException()

构建了一个 SQLClientInfoException对象。的 reason， SQLState，和failedproperties列表初始化为 null和厂商代码初始化为0。的 cause没有初始化，并随后可被调用的方法的 Throwable.initCause(java.lang.Throwable)初始化。

从以下版本开始：

一点六

SQLClientInfoException

public SQLClientInfoException(Map<String,ClientInfoStatus> failedProperties)

构建了一个 SQLClientInfoException对象与一个给定的 failedProperties初始化。的 reason和 SQLState初始化为 null和厂商代码初始化为0。的 cause没有初始化，并随后可被调用的方法的 Throwable.initCause(java.lang.Throwable)初始化。

参数

failedProperties -Map包含的属性值，无法设置。在Map的钥匙包含客户端的信息的性质，无法设置名称和值包含一个在 ClientInfoStatus

定义原因代码

从以下版本开始：

一点六

SQLClientInfoException

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

构建了一个 SQLClientInfoException对象与一个给定的 cause和 failedProperties初始化。的 reason初始化为 null如果 cause==null或 cause.toString()如果 cause!=null和厂商代码初始化为0。

参数

failedProperties -Map包含的属性值，无法设置。在Map的钥匙包含客户端的信息的性质，无法设置名称和值包含一个在 ClientInfoStatus定义代码的原因

cause -（这是以后的 getCause()方法检索）；可能是null指示的原因是不存在的或未知的。

从以下版本开始：

一点六

SQLClientInfoException

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

构建了一个 SQLClientInfoException对象与一个给定的 reason和 failedProperties初始化。的 SQLState初始化为 null和厂商代码初始化为0。的 cause没有初始化，并随后可被调用的方法的 Throwable.initCause(java.lang.Throwable)初始化。

参数

reason -描述的例外

failedProperties -Map包含的属性值，无法设置。在Map的钥匙包含客户端的信息的性质，无法设置名称和值包含一个在 ClientInfoStatus

定义原因代码

从以下版本开始：

一点六

SQLClientInfoException

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

构建了一个 SQLClientInfoException对象初始化一个给定的 reason， cause和 failedProperties。的 SQLState初始化为 null和厂商代码初始化为0。

参数

reason -描述的例外

failedProperties -Map包含的属性值，无法设置。在Map的钥匙包含客户端的信息的性质，无法设置名称和值包含一个在 ClientInfoStatus定义代码的原因

cause -这 SQLException的根本原因（这是以后的 getCause()方法检索）；可能是null指示的原因是不存在的或未知的。

从以下版本开始：

一点六

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

定义原因代码

从以下版本开始：

一点六

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指示的原因是不存在的或未知的。

从以下版本开始：

一点六

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

定义原因代码

从以下版本开始：

一点六

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指示的原因是不存在的或未知的。

从以下版本开始：

一点六

方法详细信息

getFailedProperties

public Map<String,ClientInfoStatus> getFailedProperties()

返回无法设置的客户端信息属性的列表。在Map的钥匙包含客户端的信息的性质，无法设置名称和值包含一个在 ClientInfoStatus

定义原因代码

结果

Map列表中包含客户信息的性质，无法设置

从以下版本开始：

一点六