Module java.sql
Package java.sql

Class 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
参见:

  • Constructor Details

    • SQLClientInfoException

      public SQLClientInfoException()
      构造一个SQLClientInfoException对象。reason、SQLState和失败的属性列表被初始化为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 - 引起此SQLException的原因（稍后可通过getCause()方法检索）；可能为null，表示原因不存在或未知。
      自从:
      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，表示原因不存在或未知。
      自从:
      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，表示原因不存在或未知。
      自从:
      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，表示原因不存在或未知。
      自版本:
      1.6

  • Method Details

    • getFailedProperties

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