SQLException (Java Platform SE 7)

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

- コンストラクタの詳細
  - 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, 2013, Oracle and/or its affiliates. All rights reserved.

クラス SQLException

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

メソッドのサマリー

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

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

コンストラクタの詳細

SQLException

SQLException

SQLException

SQLException

SQLException

SQLException

SQLException

SQLException

メソッドの詳細

getSQLState

getErrorCode

getNextException

setNextException

iterator