JDBC学习笔记之SQLException介绍

1. SQLException 的概述

当使用 JDBC 与数据源(在本文中的数据源表示我们实际使用的数据库)进行交互的时候遇见错误的时候，将会抛出名为 SQLException 的异常。一个 SQLException 的异常里面包含以下信息，用于帮助我们更好的定位错误。

1. 错误表示：
   
   使用 getMessage 方法便可以获取。
2. SQLState 代码
   
   代码有五位的字母和数字组成 。多数的代码由 ISO/ANSI 和 Open Group(X/Open) 标准化，但是仍然存在部分的代码由数据库提供商自行实现。
   
   使用 getSQLState 方法便可以获取。
3. 错误代码
   
   与 SQLState 不同，错误代码是由数据库提供商自行定义的整数值，存在是由基础数据源返回的实际错误代码的可能。
   
   使用 getErrorCode 方法便可以获取。
4. 错误原因
   
   表示引发异常的原因，通过不断调用 getCause 方法可以获取异常发生的底层原因。
5. 异常链
   
   如果出现多个错误，则通过此链引用异常。
   
   使用 getNextException 方法便可以获取。

2. SQLException的示例

public static void printSQLException(SQLException e){
    for(Throwable e ：ex){
        if (e instanceof SQLException){
            if(ignoreSQLException(((SQLException)e).getSQLState()) == false){
                e.printStackTrace(System.err);
                System.err.println("SQLState:" + ((SQLException)e).getSQLState());
                System.err.println("Error Code:" + ((SQLException)e).getErrorCode());
                System.err.println("Message:" + e.getMessage());
                Throwable t = ex.getCause();
                while(t != null){
                    System.out.println("Cause :" + t);
                    t = t.getCause();
                }
            }
        }
    }
}

public static boolean ignoreSQLException(String sqlState){
    if(sqlState == null){
        System.out.println("The SQL state is not defined");
    }

    // X0Y32：Jar file already exists in schema
    if(sqlState.equalsIgnoreCase("X0Y32")){
        return true;
    }

    // 42Y55：Table already exists in schema
    if(sqlState.equalsIgnoreCase("42Y55")){
        return true;
    }

    return true;
}

说明：上面的代码取自 [http:docs.oracle.com] (http://docs.oracle.com/javase/tutorial/jdbc/basics/sqlexception.html)。

3. SQLWarning

SQLWarning 是 SQLException 的一个非常重要的子类，用于表示数据库访问时出现的警告。作为异常，SQLWarning 不会停止执行应用程序，而是提醒用户没有按计划发生任何事情。比如，警告有可能会通知你尝试撤销的某个权限没有成功，或者通知你在请求断开的时间可能发生错误。

SQLWarning 有可能被 Connection 、Statement (包括 PreparedStatement 和 CallableStatement)或 ResultSet 报告，这些类都存在 getWarnings 方法，通过调用该方法才能看到调用对象上报告的第一个警告。如果 getWarning 返回一个警告，我们可以调用其 getNextWarning 方法获取下一个警告。每执行一行语句，那么前面那行语句的警告将会清除，这意味着如果我们想要检索报告处理来的警告，那么必须在下一行语句执行之前检索。

DataTruncation 是最常见的警告，其SQLState代码均为01004，表示在读取和写入数据的时候存在问题。DataTruncation 有很多方法可以帮助我们去理解哪个列或参数数据被截断，截断是在读取还是写入操作，应该传输多少字节以及实际传输的字节数。

4. 其他类型的SQLException

1. BatchUpdateException：在批处理更新操作期间发生错误时，将引发除了所提供的信息，提供的更新计数被处死之前出现了错误的所有语句。
2. SQLClientInfoException：当无法在连接上设置一个或多个客户端信息属性时引发。除了所提供的信息，也提供了不设置的客户端信息属性的列表。
3. so on...