java.sql

クラス SQLClientInfoException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.sql.SQLException

java.sql.SQLClientInfoException

すべての実装されたインタフェース:

Serializable, Iterable<Throwable>

public class SQLClientInfoException
extends SQLException

1 つ以上のクライアント情報プロパティーを Connection で設定できなかったときに、SQLException のサブクラスがスローされます。SQLClientInfoException は、SQLException で提供される情報のほかに、設定されなかったクライアント情報プロパティーのリストを提供します。 一部のデータベースでは、複数のクライアント情報プロパティーを原子的に設定することが許可されません。このようなデータベースでは、Connection.setClientInfo メソッドが例外をスローした場合でも、クライアント情報プロパティーの一部が設定された可能性があります。設定されなかったクライアント情報プロパティーのリストを取得するために、アプリケーションでは getFailedProperties メソッドを使用できます。プロパティーは、Map<String,ClientInfoStatus> を適切な SQLClientInfoException コンストラクタに渡すことで識別されます。

導入されたバージョン:

1.6

関連項目:

ClientInfoStatus, Connection.setClientInfo(java.lang.String, java.lang.String), 直列化された形式

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
SQLClientInfoException() SQLClientInfoException オブジェクトを構築します。
SQLClientInfoException(Map<String,ClientInfoStatus> failedProperties) 指定された failedProperties で初期化された SQLClientInfoException オブジェクトを構築します。
SQLClientInfoException(Map<String,ClientInfoStatus> failedProperties, Throwable cause) 指定された cause と failedProperties で初期化された SQLClientInfoException オブジェクトを構築します。
SQLClientInfoException(String reason, Map<String,ClientInfoStatus> failedProperties) 指定された reason と failedProperties で初期化された SQLClientInfoException オブジェクトを構築します。
SQLClientInfoException(String reason, Map<String,ClientInfoStatus> failedProperties, Throwable cause) 指定された reason、cause、および failedProperties で初期化された SQLClientInfoException オブジェクトを構築します。
SQLClientInfoException(String reason, String SQLState, int vendorCode, Map<String,ClientInfoStatus> failedProperties) 指定された reason、SQLState、vendorCode、および failedProperties で初期化された SQLClientInfoException オブジェクトを構築します。
SQLClientInfoException(String reason, String SQLState, int vendorCode, Map<String,ClientInfoStatus> failedProperties, Throwable cause) 指定された reason、SQLState、cause、vendorCode、および failedProperties で初期化された SQLClientInfoException オブジェクトを構築します。
SQLClientInfoException(String reason, String SQLState, Map<String,ClientInfoStatus> failedProperties) 指定された reason、SQLState、および failedProperties で初期化された SQLClientInfoException オブジェクトを構築します。
SQLClientInfoException(String reason, String SQLState, Map<String,ClientInfoStatus> failedProperties, Throwable cause) 指定された reason、SQLState、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

コンストラクタの詳細

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 に初期化され、ベンダーコードは 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 オブジェクトを構築します。 reason は、cause==null の場合に null に初期化され、cause!=null の場合に cause.toString() に初期化され、ベンダーコードは 0 に初期化されます。

パラメータ:

failedProperties - 設定できなかったプロパティー値を含む Map。Map のキーには設定できなかったクライアント情報プロパティーの名前が含まれ、値には ClientInfoStatus で定義された理由コードのいずれかが含まれる

cause - (あとで 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

メソッドの詳細

getFailedProperties

public Map<String,ClientInfoStatus> getFailedProperties()

設定できなかったクライアント情報プロパティーのリストを返します。Map のキーには設定できなかったクライアント情報プロパティーの名前が含まれ、値には ClientInfoStatus で定義された理由コードのいずれかが含まれます

戻り値:

設定できなかったクライアント情報プロパティーが格納された Map リスト

導入されたバージョン:

1.6