模块 java.sql
包 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 SQL异常
当无法在 Connection 上设置一个或多个客户端信息属性时，将抛出 SQLException 的子类。除了 SQLException 提供的信息外，SQLClientInfoException 还提供了未设置的客户端信息属性列表。某些数据库不允许以原子方式设置多个客户端信息属性。对于这些数据库，即使 Connection.setClientInfo 方法抛出异常，也可能设置了一些客户端信息属性。应用程序可以使用 getFailedProperties 方法来检索未设置的客户端信息属性列表。通过将 Map<String,ClientInfoStatus> 传递给适当的 SQLClientInfoException 构造函数来标识属性。
自从：
1.6
参见：

  • 构造方法详细信息

    • 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初始化为null，供应商代码初始化为0。
      参数：
      failedProperties - 包含无法设置的属性值的map。 Map 中的键包含无法设置的客户端信息属性的名称，值包含 ClientInfoStatus 中定义的原因代码之一
      cause - （保存以供以后通过 getCause() 方法检索）；可能为空，表示原因不存在或未知。
      自从：
      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() 方法检索）；可能为空，表示原因不存在或未知。
      自从：
      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() 方法检索）；可能为空，表示原因不存在或未知。
      自从：
      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() 方法检索）；可能为空，表示原因不存在或未知。
      自从：
      1.6

  • 方法详情

    • getFailedProperties

      public Map <String ,ClientInfoStatus > getFailedProperties()
      返回无法设置的客户端信息属性列表。 Map 中的键包含无法设置的客户端信息属性的名称，值包含 ClientInfoStatus 中定义的原因代码之一
      返回：
      包含无法设置的客户端信息属性的映射列表
      自从：
      1.6