JavaTM Platform
Standard Ed. 6

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)
          指定された reasoncause、および failedProperties で初期化された SQLClientInfoException オブジェクトを構築します。
SQLClientInfoException(String reason, String SQLState, int vendorCode, Map<String,ClientInfoStatus> failedProperties)
          指定された reasonSQLStatevendorCode、および failedProperties で初期化された SQLClientInfoException オブジェクトを構築します。
SQLClientInfoException(String reason, String SQLState, int vendorCode, Map<String,ClientInfoStatus> failedProperties, Throwable cause)
          指定された reasonSQLStatecausevendorCode、および failedProperties で初期化された SQLClientInfoException オブジェクトを構築します。
SQLClientInfoException(String reason, String SQLState, Map<String,ClientInfoStatus> failedProperties)
          指定された reasonSQLState、および failedProperties で初期化された SQLClientInfoException オブジェクトを構築します。
SQLClientInfoException(String reason, String SQLState, Map<String,ClientInfoStatus> failedProperties, Throwable cause)
          指定された reasonSQLStatecause、および failedProperties で初期化された SQLClientInfoException オブジェクトを構築します。
 
メソッドの概要
 Map<String,ClientInfoStatus> getFailedProperties()
          設定できなかったクライアント情報プロパティーのリストを返します。
 
クラス java.sql.SQLException から継承されたメソッド
getErrorCode, getNextException, getSQLState, iterator, setNextException
 
クラス java.lang.Throwable から継承されたメソッド
fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
 
クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

コンストラクタの詳細

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 オブジェクトを構築します。reason および SQLStatenull に初期化され、ベンダーコードは 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 オブジェクトを構築します。 reasoncause==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 オブジェクトを構築します。SQLStatenull に初期化され、ベンダーコードは 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)
指定された reasoncause、および failedProperties で初期化された SQLClientInfoException オブジェクトを構築します。SQLStatenull に初期化され、ベンダーコードは 0 に初期化されます。 

パラメータ:
reason - 例外の説明
failedProperties - 設定できなかったプロパティー値を含む Map。Map のキーには設定できなかったクライアント情報プロパティーの名前が含まれ、値には ClientInfoStatus で定義された理由コードのいずれかが含まれる
cause - この SQLException の基となる原因 (あとで getCause() メソッドで取得するために保存される)。null 値が許可されており、原因が存在しないか不明であることを示す 

導入されたバージョン:
1.6

SQLClientInfoException

public SQLClientInfoException(String reason,
                              String SQLState,
                              Map<String,ClientInfoStatus> failedProperties)
指定された reasonSQLState、および 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)
指定された reasonSQLStatecause、および 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)
指定された reasonSQLStatevendorCode、および 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)
指定された reasonSQLStatecausevendorCode、および 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

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2009 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。