クラス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は次のような情報を提供します。

  • エラーを説明する文字列。 これは、メソッドgetMessageを介して使用可能なJava例外メッセージとして使用されます。
  • 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オブジェクトを追加します。

    Throwableクラスで宣言されたメソッド

    addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
    修飾子と型
    メソッド
    説明
    final void
    addSuppressed(Throwable exception)
    この例外を提供する目的で抑制された例外に、指定された例外を追加します。
    Throwable
    fillInStackTrace()
    実行スタック・トレースを埋め込みます。
    Throwable
    getCause()
    このスロー可能オブジェクトの原因を返しますが、原因が存在しないか不明な場合はnullを返します。
    String
    getLocalizedMessage()
    このスロー可能オブジェクトの、ローカライズされた記述を作成します。
    String
    getMessage()
    このスロー可能オブジェクトの詳細メッセージ文字列を返します。
    StackTraceElement[]
    getStackTrace()
    Throwable.printStackTrace()によって出力されるスタック・トレース情報にプログラムでアクセスできるようにします。
    final Throwable[]
    getSuppressed()
    この例外を提供する目的で(通常try-with-resources文によって)抑制された例外をすべて含む配列を返します。
    Throwable
    initCause(Throwable cause)
    このスロー可能オブジェクトの原因を、指定された値に初期化します。
    void
    printStackTrace()
    このスロー可能オブジェクトおよびそのバックトレースを標準エラー・ストリームに出力します。
    void
    printStackTrace(PrintStream s)
    このスロー可能オブジェクトとそのバックトレースを指定された印刷ストリームに出力します。
    void
    printStackTrace(PrintWriter s)
    このスロー可能オブジェクトとそのバックトレースを指定されたプリント・ライターに出力します。
    void
    setStackTrace(StackTraceElement[] stackTrace)
    Throwable.getStackTrace()によって返され、Throwable.printStackTrace()と関連メソッドによって出力される、スタック・トレース要素を設定します。
    String
    toString()
    このスロー可能オブジェクトの短い記述を返します。

    クラスオブジェクトで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
    修飾子と型
    メソッド
    説明
    protected Object
    clone()
    このオブジェクトのコピーを作成して、返します。
    boolean
    equals(Object obj)
    このオブジェクトと他のオブジェクトが等しいかどうかを示します。
    protected void
    finalize()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は非推奨であり、将来のリリースで削除される可能性があります。
    final Class<?>
    getClass()
    このObjectの実行時クラスを返します。
    int
    hashCode()
    このオブジェクトに対するハッシュ・コード値を返します。
    final void
    notify()
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    notifyAll()
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    final void
    wait()
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

    インタフェースIterableで宣言されたメソッド

    forEach, spliterator
    修飾子と型
    メソッド
    説明
    default void
    forEach(Consumer<? super Throwable> action)
    Iterableの各要素に対して指定されたアクションを、すべての要素が処理されるか、アクションが例外をスローするまで実行します。
    default Spliterator<Throwable>
    spliterator()
    このIterableによって記述される要素に対するSpliteratorを作成します。

  • コンストラクタの詳細

    • 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

      public void setNextException(SQLException ex)
      チェーンの最後にSQLExceptionオブジェクトを追加します。
      パラメータ:
      ex - SQLExceptionチェーンの最後に追加される新しい例外
      関連項目:

    • iterator

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