SQLException (Java Platform SE 8)

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 Exceptionメッセージとして使用され、getMesasgeメソッドにより使用できます。
- XOPEN SQLstate変換またはSQL:2003変換に続くSQLstate文字列。SQLState文字列の値は該当する仕様で記述されています。DatabaseMetaDataメソッドgetSQLStateTypeにより、ドライバがXOPENの型とSQL:2003の型のどちらを返すかを確認できます。
- ベンダー固有の整数型のエラー・コード。通常これは、基になるデータベースによって返される実際のエラー・コードです。
- 次のExceptionへのチェーン。これは追加のエラー情報を提供するために使用できます。
- 原因の関係(このSQLExceptionに対して存在する場合)。
関連項目:

直列化された形式

コンストラクタのサマリー

コンストラクタ
コンストラクタと説明
`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

クラス java.lang.Objectから継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

インタフェースjava.lang.Iterableから継承されたメソッド
forEach, 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(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

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.

クラスSQLException

コンストラクタのサマリー

メソッドのサマリー

クラス java.lang.Throwableから継承されたメソッド

クラス java.lang.Objectから継承されたメソッド

インタフェースjava.lang.Iterableから継承されたメソッド

コンストラクタの詳細

SQLException

SQLException

SQLException

SQLException

SQLException

SQLException

SQLException

SQLException

メソッドの詳細

getSQLState

getErrorCode

getNextException

setNextException

iterator