java.sql
クラス SQLException

java.lang.Object
  |
  +--java.lang.Throwable
        |
        +--java.lang.Exception
              |
              +--java.sql.SQLException

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

Serializable

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

BatchUpdateException, SQLWarning

public class SQLException

extends Exception

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

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

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

関連項目:

直列化された形式

コンストラクタの概要

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

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

SQLException(String reason, String SQLState)
指定された reason と SQLState で SQLException オブジェクトを構築します。

SQLException(String reason, String SQLState, int vendorCode)
完全指定の SQLException オブジェクトを構築します。

メソッドの概要

int	getErrorCode() この SQLException オブジェクトのベンダー固有の例外コードを取得します。
SQLException	getNextException() この SQLException オブジェクトにチェーンされた例外を取得します。
String	getSQLState() この SQLException オブジェクトの SQLState を取得します。
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)

完全指定の SQLException オブジェクトを構築します。

パラメータ:

reason - 例外の説明

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

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

SQLException

public SQLException(String reason,
                    String SQLState)

指定された reason と SQLState で SQLException オブジェクトを構築します。vendorCode フィールドのデフォルトは 0 に設定されます。

パラメータ:

reason - 例外の説明

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

SQLException

public SQLException(String reason)

指定された reason で SQLException オブジェクトを構築します。SQLState フィールドのデフォルトは null、vendorCode フィールドのデフォルトは 0 にそれぞれ設定されます。

パラメータ:

reason - 例外の説明

SQLException

public SQLException()

SQLException オブジェクトを構築します。reason フィールドのデフォルトは null、SQLState フィールドのデフォルトは null、vendorCode フィールドのデフォルトは 0 にそれぞれ設定されます。

メソッドの詳細

getSQLState

public String getSQLState()

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

戻り値:

SQLState 値

getErrorCode

public int getErrorCode()

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

戻り値:

ベンダーのエラーコード

getNextException

public SQLException getNextException()

この SQLException オブジェクトにチェーンされた例外を取得します。

戻り値:

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

関連項目:

setNextException(java.sql.SQLException)

setNextException

public void setNextException(SQLException ex)

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

パラメータ:

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

関連項目:

getNextException()