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提供的信息SQLException ， SQLClientInfoException还提供了未设置的客户端信息属性列表。 某些数据库不允许以原子方式设置多个客户端信息属性。 对于这些数据库，尽管Connection.setClientInfo方法抛出异常，但有可能某些客户端信息属性已设置。 应用程序可以使用getFailedProperties方法来检索未设置的客户端信息属性列表。 通过将Map<String,ClientInfoStatus>传递给Map<String,ClientInfoStatus>的SQLClientInfoException SQLClientInfoException函数来SQLClientInfoException属性。

从以下版本开始：

1.6

另请参见：

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) 构造一个用给定的 reason和 failedProperties初始化的 SQLClientInfoException对象。
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

构造方法详细信息

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定义的原因代码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定义的原因代码ClientInfoStatus

cause - （由getCause()方法保存供以后检索）; 可能为空，表示原因不存在或未知。

从以下版本开始：

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定义的原因代码ClientInfoStatus

从以下版本开始：

1.6

SQLClientInfoException

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

构造一个SQLClientInfoException与给定的初始化的对象reason ， cause和failedProperties 。 SQLState初始化为null ，供应商代码初始化为0。

参数

reason - 异常的描述

failedProperties - 包含无法设置的属性值的地图。 地图中的键包含无法设置的客户端信息属性的名称，值包含ClientInfoStatus定义的原因代码ClientInfoStatus

cause -底层原因SQLException （保存用于由稍后检索getCause()方法）; 可能为空，表示原因不存在或未知。

从以下版本开始：

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 - SQLState的XOPEN或SQL：2003代码

failedProperties - 包含无法设置的属性值的地图。 地图中的键包含无法设置的客户端信息属性的名称，值包含ClientInfoStatus定义的原因代码ClientInfoStatus

从以下版本开始：

1.6

SQLClientInfoException

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

构造一个SQLClientInfoException与给定的初始化的对象reason ， SQLState ， cause和failedProperties 。 供应商代码初始化为0。

参数

reason - 异常的描述

SQLState - SQLState的XOPEN或SQL：2003代码

failedProperties - 包含无法设置的属性值的地图。 地图中的键包含无法设置的客户端信息属性的名称，值包含ClientInfoStatus定义的原因代码ClientInfoStatus

cause -底层原因SQLException （保存用于由稍后检索getCause()方法）; 可能为空，表示原因不存在或未知。

从以下版本开始：

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 - SQLState的XOPEN或SQL：2003代码

vendorCode - 数据库供应商特定的异常代码

failedProperties - 包含无法设置的属性值的地图。 地图中的键包含无法设置的客户端信息属性的名称，值包含ClientInfoStatus定义的原因代码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 - SQLState的XOPEN或SQL：2003代码

vendorCode - 数据库供应商特定的异常代码

failedProperties - 包含无法设置的属性值的地图。 地图中的键包含无法设置的客户端信息属性的名称，值包含ClientInfoStatus定义的原因代码ClientInfoStatus

cause - 这个SQLException （其保存以供稍后通过getCause()方法cause ）的根本原因; 可能为空，表示原因不存在或未知。

从以下版本开始：

1.6

方法详细信息

getFailedProperties

public Map<String,ClientInfoStatus> getFailedProperties()

返回无法设置的客户端信息属性列表。 地图中的键包含无法设置的客户端信息属性的名称，值包含ClientInfoStatus定义的原因代码ClientInfoStatus

结果

包含无法设置的客户端信息属性的地图列表

从以下版本开始：

1.6