- 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
的子类。 除了SQLClientInfoException
提供的信息SQLException
,SQLClientInfoException
还提供了未设置的客户端信息属性列表。 某些数据库不允许以原子方式设置多个客户端信息属性。 对于这些数据库,即使Connection.setClientInfo
方法引发异常,也可能已设置了某些客户端信息属性。 应用程序可以使用getFailedProperties
方法检索未设置的客户端信息属性列表。 通过将Map<String,ClientInfoStatus>
传递给适当的SQLClientInfoException
构造函数来标识属性。- 从以下版本开始:
- 1.6
- 另请参见:
-
ClientInfoStatus
,Connection.setClientInfo(java.lang.String, java.lang.String)
, Serialized Form
-
-
构造方法摘要
构造方法 构造器 描述 SQLClientInfoException()
构造一个SQLClientInfoException
对象。SQLClientInfoException(String reason, String SQLState, int vendorCode, Map<String,ClientInfoStatus> failedProperties)
构造一个SQLClientInfoException
与给定的初始化的对象reason
,SQLState
,vendorCode
和failedProperties
。SQLClientInfoException(String reason, String SQLState, int vendorCode, Map<String,ClientInfoStatus> failedProperties, Throwable cause)
构造一个SQLClientInfoException
与给定的初始化的对象reason
,SQLState
,cause
,vendorCode
和failedProperties
。SQLClientInfoException(String reason, String SQLState, Map<String,ClientInfoStatus> failedProperties)
构造一个SQLClientInfoException
与给定的初始化的对象reason
,SQLState
和failedProperties
。SQLClientInfoException(String reason, String SQLState, Map<String,ClientInfoStatus> failedProperties, Throwable cause)
构造一个SQLClientInfoException
与给定的初始化的对象reason
,SQLState
,cause
和failedProperties
。SQLClientInfoException(String reason, Map<String,ClientInfoStatus> failedProperties)
构造使用给定的reason
和failedProperties
初始化的SQLClientInfoException
对象。SQLClientInfoException(String reason, Map<String,ClientInfoStatus> failedProperties, Throwable cause)
构造一个SQLClientInfoException
与给定的初始化的对象reason
,cause
和failedProperties
。SQLClientInfoException(Map<String,ClientInfoStatus> failedProperties)
构造使用给定的failedProperties
初始化的SQLClientInfoException
对象。SQLClientInfoException(Map<String,ClientInfoStatus> failedProperties, Throwable cause)
构造用给定的cause
和failedProperties
初始化的SQLClientInfoException
对象。
-
方法摘要
所有方法 实例方法 具体的方法 变量和类型 方法 描述 Map<String,ClientInfoStatus>
getFailedProperties()
返回无法设置的客户端信息属性列表。-
声明方法的类 java.sql.SQLException
getErrorCode, getNextException, getSQLState, iterator, setNextException
-
声明方法的类 java.lang.Throwable
addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
-
声明方法的类 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
声明方法的接口 java.lang.Iterable
forEach, spliterator
-
-
-
-
构造方法详细信息
-
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
-
-