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例外メッセージとして使用され、メソッドgetMessageで使用できます。
- 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, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。

クラスSQLException

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

メソッドのサマリー

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

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

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

コンストラクタの詳細

SQLException

SQLException

SQLException

SQLException

SQLException

SQLException

SQLException

SQLException

メソッドの詳細

getSQLState

getErrorCode

getNextException

setNextException

iterator