java.sql
クラス SQLException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          java.sql.SQLException

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

Serializable, Iterable<Throwable>

直系の既知のサブクラス:

BatchUpdateException, RowSetWarning, SerialException, SQLClientInfoException, SQLNonTransientException, SQLRecoverableException, SQLTransientException, SQLWarning, SyncFactoryException, SyncProviderException

public class SQLException
extends Exception
implements Iterable<Throwable>

データベースアクセスエラーまたはその他のエラーに関する情報を提供する例外です。

各 SQLException は次のような情報を提供します。

• エラーを説明する文字列。これは、Java Exception メッセージとして使用され、getMesasge メソッドにより使用できます。
• XOPEN SQLstate 変換または SQL:2003 変換に続く SQLstate 文字列。SQLState 文字列の値は該当する仕様で記述されています。DatabaseMetaData メソッド getSQLStateType により、ドライバが XOPEN の型と SQL:2003 の型のどちらを返すかを確認できます。
• ベンダー固有の整数型のエラーコード。通常これは、基本的にデータベースによって返される実際のエラーコードです。
• 次の Exception へのチェーン。これは追加のエラー情報を提供するために使用できます。
• 原因の関係 (この SQLException に対して存在する場合)。

関連項目:

直列化された形式

コンストラクタの概要

SQLException()
SQLException オブジェクトを構築します。

SQLException(String reason)
指定の reason で SQLException オブジェクトを構築します。

SQLException(String reason, String SQLState)
指定の reason および SQLState で SQLException オブジェクトを構築します。

SQLException(String reason, String SQLState, int vendorCode)
指定の reason、SQLState、および vendorCode で SQLException オブジェクトを構築します。

SQLException(String reason, String sqlState, int vendorCode, Throwable cause)
指定の reason、SQLState、vendorCode、および cause で SQLException オブジェクトを構築します。

SQLException(String reason, String sqlState, Throwable cause)
指定の reason、SQLState、および cause で SQLException オブジェクトを構築します。

SQLException(String reason, Throwable cause)
指定の reason および cause で SQLException オブジェクトを構築します。

SQLException(Throwable cause)
指定の cause で SQLException オブジェクトを構築します。

メソッドの概要

int	getErrorCode() この SQLException オブジェクトのベンダー固有の例外コードを取得します。
SQLException	getNextException() setNextException(SQLException ex) によってこの SQLException オブジェクトにチェーンされた例外を取得します。
String	getSQLState() この SQLException オブジェクトの SQLState を取得します。
Iterator<Throwable>	iterator() チェーンされた SQLException についての反復子を返します。
void	setNextException(SQLException ex) チェーンの最後に SQLException オブジェクトを追加します。

クラス 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

コンストラクタの詳細

SQLException

public SQLException(String reason,
                    String SQLState,
                    int vendorCode)

指定の reason、SQLState、および vendorCode で SQLException オブジェクトを構築します。 cause は初期化されません。Throwable.initCause(java.lang.Throwable) メソッドを呼び出すことによって、あとでこれを初期化できます。

パラメータ:

reason - 例外の説明

SQLState - 例外を識別する XOPEN コードまたは SQL:2003 コード

vendorCode - データベースベンダー固有の例外コード

SQLException

public SQLException(String reason,
                    String SQLState)

指定の reason および SQLState で SQLException オブジェクトを構築します。 cause は初期化されません。Throwable.initCause(java.lang.Throwable) メソッドを呼び出すことによって、あとでこれを初期化できます。ベンダーコードは 0 に初期化されます。

パラメータ:

reason - 例外の説明

SQLState - 例外を識別する XOPEN コードまたは SQL:2003 コード

SQLException

public SQLException(String reason)

指定の reason で SQLException オブジェクトを構築します。SQLState は null に初期化され、ベンダーコードは 0 に初期化されます。 cause は初期化されません。Throwable.initCause(java.lang.Throwable) メソッドを呼び出すことによって、あとでこれを初期化できます。

パラメータ:

reason - 例外の説明

SQLException

public SQLException()

SQLException オブジェクトを構築します。reason および SQLState は null に初期化され、ベンダーコードは 0 に初期化されます。 cause は初期化されません。Throwable.initCause(java.lang.Throwable) メソッドを呼び出すことによって、あとでこれを初期化できます。

SQLException

public SQLException(Throwable cause)

指定の cause で SQLException オブジェクトを構築します。SQLState は null に初期化され、ベンダーコードは 0 に初期化されます。reason は cause==null の場合に null に初期化され、cause!=null の場合に cause.toString() に初期化されます。

パラメータ:

cause - この SQLException の基となる原因 (あとで getCause() メソッドで取得するために保存される)。null 値が許可されており、原因が存在しないか不明であることを示す

導入されたバージョン:

1.6

SQLException

public SQLException(String reason,
                    Throwable cause)

指定の reason および cause で SQLException オブジェクトを構築します。SQLState は null に初期化され、ベンダーコードは 0 に初期化されます。

パラメータ:

reason - 例外の説明

cause - この SQLException の基となる原因 (あとで getCause() メソッドで取得するために保存される)。null 値が許可されており、原因が存在しないか不明であることを示す

導入されたバージョン:

1.6

SQLException

public SQLException(String reason,
                    String sqlState,
                    Throwable cause)

指定の reason、SQLState、および cause で SQLException オブジェクトを構築します。ベンダーコードは 0 に初期化されます。

パラメータ:

reason - 例外の説明

sqlState - 例外を識別する XOPEN コードまたは SQL:2003 コード

cause - この SQLException の基となる原因 (あとで getCause() メソッドで取得するために保存される)。null 値が許可されており、原因が存在しないか不明であることを示す

導入されたバージョン:

1.6

SQLException

public SQLException(String reason,
                    String sqlState,
                    int vendorCode,
                    Throwable cause)

指定の reason、SQLState、vendorCode、および cause で SQLException オブジェクトを構築します。

パラメータ:

reason - 例外の説明

sqlState - 例外を識別する XOPEN コードまたは SQL:2003 コード

vendorCode - データベースベンダー固有の例外コード

cause - この SQLException の基となる原因 (あとで getCause() メソッドで取得するために保存される)。null 値が許可されており、原因が存在しないか不明であることを示す

導入されたバージョン:

1.6

メソッドの詳細

getSQLState

public String getSQLState()

この SQLException オブジェクトの SQLState を取得します。

戻り値:

SQLState 値

getErrorCode

public int getErrorCode()

この SQLException オブジェクトのベンダー固有の例外コードを取得します。

戻り値:

ベンダーのエラーコード

getNextException

public SQLException getNextException()

setNextException(SQLException ex) によってこの SQLException オブジェクトにチェーンされた例外を取得します。

戻り値:

チェーンの次の SQLException オブジェクト。ない場合は null

関連項目:

setNextException(java.sql.SQLException)

setNextException

public void setNextException(SQLException ex)

チェーンの最後に SQLException オブジェクトを追加します。

パラメータ:

ex - SQLException チェーンの最後に追加される新しい例外

関連項目:

getNextException()

iterator

public Iterator<Throwable> iterator()

チェーンされた SQLException についての反復子を返します。反復子は、各 SQLException とその基になる原因 (存在する場合) を反復するために使用されます。

定義:

インタフェース Iterable<Throwable> 内の iterator

戻り値:

チェーンされた SQLException と原因を適切な順序で繰り返し処理する反復子

導入されたバージョン:

1.6