模块  java.sql
软件包  java.sql

Class SQLClientInfoException

  • 实现的所有接口
    Serializable ， Iterable<Throwable> 
    public class SQLClientInfoException
extends SQLException
    当无法在Connection上设置一个或多个客户端信息属性时，将引发SQLException的子类。 除了SQLClientInfoException提供的信息SQLException ， SQLClientInfoException还提供了未设置的客户端信息属性列表。 某些数据库不允许以原子方式设置多个客户端信息属性。 对于这些数据库，即使Connection.setClientInfo方法引发异常，也可能已设置了某些客户端信息属性。 应用程序可以使用getFailedProperties方法检索未设置的客户端信息属性列表。 通过将Map<String,ClientInfoStatus>传递给适当的SQLClientInfoException构造函数来标识属性。
    从以下版本开始：
    1.6
    另请参见：
    ClientInfoStatus ， Connection.setClientInfo(java.lang.String, java.lang.String) ， Serialized Form

    • 构造方法详细信息

      • 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 ，供应商代码初始化为cause未初始化，随后可通过调用Throwable.initCause(java.lang.Throwable)方法进行初始化。
        参数
        failedProperties - 包含无法设置的属性值的Map。 Map中的键包含无法设置的客户端信息属性的名称，值包含ClientInfoStatus定义的原因代码ClientInfoStatus
        从以下版本开始：
        1.6

      • SQLClientInfoException

        public SQLClientInfoException​(Map<String,​ClientInfoStatus> failedProperties,
                              Throwable cause)
        构造用给定的cause和failedProperties初始化的SQLClientInfoException对象。 reason初始化为null如果为cause==null或cause.toString()如果为cause!=null且供应商代码初始化为0。
        参数
        failedProperties - 包含无法设置的属性值的Map。 Map中的键包含无法设置的客户端信息属性的名称，并且值包含ClientInfoStatus定义的原因代码ClientInfoStatus
        cause - （保存以供以后通过getCause()方法检索）; 可以为空，表示原因不存在或未知。
        从以下版本开始：
        1.6

      • SQLClientInfoException

        public SQLClientInfoException​(String reason,
                              Map<String,​ClientInfoStatus> failedProperties)
        构造用给定的reason和failedProperties初始化的SQLClientInfoException对象。 SQLState初始化为null ，供应商代码初始化为cause未初始化，随后可通过调用Throwable.initCause(java.lang.Throwable)方法进行初始化。
        参数
        reason - 异常的描述
        failedProperties - 包含无法设置的属性值的Map。 Map中的键包含无法设置的客户端信息属性的名称，并且值包含ClientInfoStatus定义的原因代码ClientInfoStatus
        从以下版本开始：
        1.6

      • SQLClientInfoException

        public SQLClientInfoException​(String reason,
                              Map<String,​ClientInfoStatus> failedProperties,
                              Throwable cause)
        构造一个SQLClientInfoException与给定的初始化的对象reason ， cause和failedProperties 。 SQLState初始化为null ，供应商代码初始化为0。
        参数
        reason - 异常的描述
        failedProperties - 包含无法设置的属性值的Map。 Map中的键包含无法设置的客户端信息属性的名称，值包含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 - 标识异常的XOPEN或SQL：2003代码
        failedProperties - 包含无法设置的属性值的Map。 Map中的键包含无法设置的客户端信息属性的名称，值包含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 - 标识异常的XOPEN或SQL：2003代码
        failedProperties - 包含无法设置的属性值的Map。 Map中的键包含无法设置的客户端信息属性的名称，值包含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 - 标识异常的XOPEN或SQL：2003代码
        vendorCode - 特定于数据库供应商的异常代码
        failedProperties - 包含无法设置的属性值的Map。 Map中的键包含无法设置的客户端信息属性的名称，值包含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 - 标识异常的XOPEN或SQL：2003代码
        vendorCode - 特定于数据库供应商的异常代码
        failedProperties - 包含无法设置的属性值的Map。 Map中的键包含无法设置的客户端信息属性的名称，值包含ClientInfoStatus定义的原因代码ClientInfoStatus
        cause - 此SQLException的基本原因（保存以供以后通过getCause()方法检索）; 可以为空，表示原因不存在或未知。
        从以下版本开始：
        1.6

    • 方法详细信息

      • getFailedProperties

        public Map<String,​ClientInfoStatus> getFailedProperties()
        返回无法设置的客户端信息属性列表。 Map中的键包含无法设置的客户端信息属性的名称，值包含ClientInfoStatus定义的原因代码ClientInfoStatus
        结果
        包含无法设置的客户端信息属性的地图列表
        从以下版本开始：
        1.6