Module  java.sql
软件包  java.sql

Class SQLClientInfoException

  • All Implemented Interfaces:
    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)
        构造一个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 - 标识异常的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 - 标识异常的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 - 标识异常的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 - 标识异常的XOPEN或SQL：2003代码
        vendorCode - 数据库供应商特定的异常代码
        failedProperties - 包含无法设置的属性值的地图。 地图中的键包含无法设置的客户端信息属性的名称，值包含ClientInfoStatus定义的原因代码ClientInfoStatus
        cause - 这个SQLException的基本原因（由getCause()方法保存以供以后检索）; 可能为空，表示原因不存在或未知。
        从以下版本开始：
        1.6

    • 方法详细信息

      • getFailedProperties

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