モジュール java.sql
パッケージ 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

        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とその基になる原因(存在する場合)を反復するために使用されます。
        定義:
        iterator、インタフェース: Iterable<Throwable>
        戻り値:
        チェーンされたSQLExceptionと原因を適切な順序で反復処理するイテレータ
        導入されたバージョン:
        1.6