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例外メッセージとして使用され、メソッド
getMessage
で使用できます。 - XOPEN SQLstate変換またはSQL:2003変換に続くSQLstate文字列。 SQLState文字列の値は該当する仕様で記述されています。
DatabaseMetaData
メソッドgetSQLStateType
により、ドライバがXOPENの型とSQL:2003の型のどちらを返すかを確認できます。 - ベンダー固有の整数型のエラー・コード。 通常これは、基になるデータベースによって返される実際のエラー・コードです。
- 次のExceptionへのチェーン。 これは追加のエラー情報を提供するために使用できます。
- 原因の関係(この
SQLException
に対して存在する場合)。
- 導入されたバージョン:
- 1.1
- 関連項目:
- 直列化された形式
-
コンストラクタのサマリー
コンストラクタ コンストラクタ 説明 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で宣言されたメソッド
addSuppressed、fillInStackTrace、getCause、getLocalizedMessage、getMessage、getStackTrace、getSuppressed、initCause、printStackTrace、printStackTrace、printStackTrace、setStackTrace、toString
-
コンストラクタの詳細
-
SQLException
指定されたreason
、SQLState
、およびvendorCode
を含むSQLException
オブジェクトを構築します。cause
は初期化されませんが、続いてThrowable.initCause(java.lang.Throwable)
メソッドを呼び出すことで初期化できます。- パラメータ:
reason
- 例外の説明SQLState
- 例外を識別するXOPENコードまたはSQL:2003コードvendorCode
- データベース・ベンダー固有の例外コード
-
SQLException
指定された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
指定されたreason
とcause
を含むSQLException
オブジェクトを構築します。SQLState
はnull
に初期化され、ベンダー・コードは0に初期化されます。- パラメータ:
reason
- 例外の説明cause
- このSQLException
の基となる原因(あとでgetCause()
メソッドで取得するために保存される)。null値が許可されており、原因が存在しないか不明であることを示す- 導入されたバージョン:
- 1.6
-
SQLException
指定されたreason
、SQLState
、およびcause
を含むSQLException
オブジェクトを構築します。 ベンダー・コードは0に初期化されます。- パラメータ:
reason
- 例外の説明sqlState
- 例外を識別するXOPENコードまたはSQL:2003コードcause
- このSQLException
の基となる原因(あとでgetCause()
メソッドで取得するために保存される)。null値が許可されており、原因が存在しないか不明であることを示す- 導入されたバージョン:
- 1.6
-
SQLException
指定された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
チェーンされたSQLExceptionについてのイテレータを返します。 イテレータは、各SQLExceptionとその基になる原因(存在する場合)を反復するために使用されます。
-