JavaのSQLExceptionクラスで使える主要メソッド一覧とその役割

SQLExceptionは、JDBCドライバー側でもデータベース側でも発生する可能性がある例外です。この例外が発生すると、SQLException型のオブジェクトがcatch節に渡され、プログラム側で詳細なエラー情報を受け取ることができます。

SQLExceptionから取得できる主なメソッド

catch節に渡されたSQLExceptionオブジェクトには、例外に関する追加情報を取得するための以下のメソッドが用意されています。

使用例：例外情報をログに出力する

実際の開発では、これらのメソッドを組み合わせて、発生したSQL例外の詳細をログに記録するのが一般的です。以下は典型的な使用例です。

try {
    // データベース操作
} catch (SQLException e) {
    System.out.println("エラーメッセージ: " + e.getMessage());
    System.out.println("エラーコード: " + e.getErrorCode());
    System.out.println("SQLState: " + e.getSQLState());
    e.printStackTrace();
}

ポイント

• getErrorCode() と getSQLState() を併用することで、ベンダー固有のエラーと標準化されたSQL状態コードの両方を確認できます。
• 複数の例外が連鎖している場合は、getNextException() をループで回すことで、チェーン全体の例外を追跡できます。
• 本番環境では printStackTrace() の代わりにロギングフレームワーク（Log4jやSLF4Jなど）へ出力するのが推奨されます。