java.sql
类 SQLClientInfoException

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

所有已实现的接口：

Serializable, Iterable<Throwable>

public class SQLClientInfoException
extends SQLException

当无法在 Connection 上设置一个或多个客户端信息属性时，抛出此 SQLException 的子类。除了 SQLException 提供的信息外，SQLClientInfoException 还提供未设置的客户端信息属性列表。 某些数据库不允许一次设置多个客户端信息属性。对于这些数据库，即使 Connection.setClientInfo 方法抛出异常，可能也已经设置了一些客户端信息属性。应用程序可以使用 getFailedProperties 方法获取未设置的客户端信息属性列表。通过将 Map<String,ClientInfoStatus> 传递给适当的 SQLClientInfoException 构造方法来标识属性。

从以下版本开始：

1.6

另请参见：

ClientInfoStatus, Connection.setClientInfo(java.lang.String, java.lang.String), 序列化表格

SQLClientInfoException

public SQLClientInfoException()

构造一个 SQLClientInfoException 对象。reason、SQLState 和 failedProperties 列表初始化为 null，供应商代码初始化为 0。cause 没有初始化，随后可以通过调用 Throwable.initCause(java.lang.Throwable) 方法来初始化。

从以下版本开始：

1.6

SQLClientInfoException

public SQLClientInfoException(Map<String,ClientInfoStatus> failedProperties)

构造一个使用给定 failedProperties 初始化的 SQLClientInfoException 对象。reason 和 SQLState 初始化为 null，供应商代码初始化为 0。 cause 没有初始化，随后可以通过调用 Throwable.initCause(java.lang.Throwable) 方法来初始化。

参数：

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

从以下版本开始：

1.6

SQLClientInfoException

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

构造一个使用给定 cause 和 failedProperties 初始化的 SQLClientInfoException 对象。 如果 cause==null，则 reason 初始化为 null；如果 cause!=null，则 reason 初始化为 cause.toString()，供应商代码初始化为 0。

参数：

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

cause - 此 SQLClientInfoException 的底层原因（保存此 cause，以供以后通过 getCause() 方法获取）；可以为 null，表示 cause 不存在或未知。

从以下版本开始：

1.6

SQLClientInfoException

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

构造一个使用给定 reason 和 failedProperties 初始化的 SQLClientInfoException 对象。SQLState 初始化为 null，供应商代码初始化为 0。 cause 没有初始化，随后可以通过调用 Throwable.initCause(java.lang.Throwable) 方法来初始化。

参数：

reason - 对异常的描述

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

从以下版本开始：

1.6

SQLClientInfoException

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

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

参数：

reason - 对异常的描述

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

cause - 此 SQLException 的底层原因（保存此原因，以供以后通过 getCause() 方法获取）；可以为 null，表示 cause 不存在或未知。

从以下版本开始：

1.6

SQLClientInfoException

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

构造一个使用给定 reason、SQLState 和 failedProperties 初始化的 SQLClientInfoException 对象。cause 没有初始化，随后可以通过调用 Throwable.initCause(java.lang.Throwable) 方法来初始化。供应商代码初始化为 0。

参数：

reason - 对异常的描述

SQLState - 标识异常的 XOPEN 或 SQL:2003 代码

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

从以下版本开始：

1.6

SQLClientInfoException

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

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

参数：

reason - 对异常的描述

SQLState - 标识异常的 XOPEN 或 SQL:2003 代码

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

cause - 此 SQLException 的底层原因（保存此原因，以供以后通过 getCause() 方法获取）；可以为 null，表示 cause 不存在或未知。

从以下版本开始：

1.6

SQLClientInfoException

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

构造一个使用给定 reason、SQLState、vendorCode 和 failedProperties 初始化的 SQLClientInfoException 对象。cause 没有初始化，随后可以通过调用 Throwable.initCause(java.lang.Throwable) 方法来初始化。

参数：

reason - 对异常的描述

SQLState - 标识异常的 XOPEN 或 SQL:2003 代码

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

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

从以下版本开始：

1.6

SQLClientInfoException

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

构造一个使用给定 reason、SQLState、cause、vendorCode 和 failedProperties 初始化的 SQLClientInfoException 对象。

参数：

reason - 对异常的描述

SQLState - 标识异常的 XOPEN 或 SQL:2003 代码

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

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

cause - 此 SQLException 的底层原因（保存此原因，以供以后通过 getCause() 方法获取）；可以为 null，表示 cause 不存在或未知。

从以下版本开始：

1.6

getFailedProperties

public Map<String,ClientInfoStatus> getFailedProperties()

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

返回：

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

从以下版本开始：

1.6

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。