モジュール java.sql
パッケージ 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例外メッセージとして使用され、メソッド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