模块  java.sql
软件包  java.sql

Class SQLClientInfoException

  • 实现的所有接口
    SerializableIterable<Throwable>

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

      • SQLClientInfoException

        public SQLClientInfoException()
        构造一个SQLClientInfoException对象。 reasonSQLState ,和failedProperties列表被初始化为null ,供应商代码被初始化为0。 cause没有初始化,随后可以通过向一个呼叫进行初始化Throwable.initCause(java.lang.Throwable)方法。
        从以下版本开始:
        1.6
      • SQLClientInfoException

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

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

        public SQLClientInfoException​(String reason,
                                      Map<String,​ClientInfoStatus> failedProperties)
        构造用给定的reasonfailedProperties初始化的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与给定的初始化的对象reasoncausefailedProperties 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与给定的初始化的对象reasonSQLStatefailedProperties 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与给定的初始化的对象reasonSQLStatecausefailedProperties 供应商代码初始化为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与给定的初始化的对象reasonSQLStatevendorCodefailedProperties 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与给定的初始化的对象 reasonSQLStatecausevendorCodefailedProperties
        参数
        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