JDBC API 4.2（十二）：SQLException 源码分析

╰+哭是因爲堅強的太久メ 2023-06-22 09:25 10阅读 0赞

### 文章目录 ###

*   *  1、简介
     *  2、异常（Exceptions）
     *  3、警告（Warnings）
     *  4、SQLException 分类
     *  5、SQLException的其他子类

## 1、简介 ##

当JDBC在与数据源交互期间遇到错误时，它将抛出SQLException实例，而不是Exception。

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTA2NDcwMzU_size_16_color_FFFFFF_t_70]

SQLException 实例包含以下信息，可以帮助您确定错误原因：

**1、error 的描述：** 调用方法SQLException.getMessage检索包含此描述的String对象。

**2、SQLState 代码：** 这些代码及其各自的含义已由 ISO/ANSI 和 Open Group (X/Open) 进行了标准化，另外还有些代码留给数据库供应商自己定义。 此String对象由五个字母数字字符组成。 通过调用方法 SQLException.getSQLState 检索此代码。

**3、错误代码：** 这是一个整数值，用于标识导致引发SQLException实例的错误。 它的值和含义是特定于实现的，并且可能是基础数据源返回的实际错误代码。 通过调用方法SQLException.getErrorCode检索错误。

**4、原因：** SQLException 实例可能具有因果关系，该因果关系由导致抛出SQLException实例的一个或多个Throwable对象组成。要获取这一系列原因信息，要递归调用方法SQLException.getCause 获取，直到返回空值。

**5、对任何链接的异常的引用：** 如果发生多个错误，则可以通过该异常引用链获取异常。 通过对引发的异常调用方法 SQLException.getNextException 来检索这些异常。

## 2、异常（Exceptions） ##

下面我们编写一个通用方法来检索SQLException中包含的SQLState，错误代码，错误描述和原因（如果有的话）以及与其链接的任何其他异常：

private static String sql = "select id,name,email,country,password from Userswhere id=1";
    
        public static void main(String[] args) {
            // Step 1: 创建连接对象 connection
            try (Connection connection = DriverManager.getConnection("jdbc:mysql://localhost:3306/lkf_db?useUnicode=true&characterEncoding=utf8&serverTimezone=GMT", "root", "root");
                 // Step 2:使用 connection 创建 stmt
                 Statement stmt = connection.createStatement();
                 // Step 3:执行SQL语句
                 ResultSet rs = stmt.executeQuery(sql)) {
                //获取结果集 rs 的元数据对象 resultSetMetaData
                ResultSetMetaData resultSetMetaData = rs.getMetaData();
                System.out.println("1. 列数量 :: " + resultSetMetaData.getColumnCount());
                System.out.println("2. 第一列名称 :: " + resultSetMetaData.getColumnName(1));
                System.out.println("3. 数据库名称 :: " + resultSetMetaData.getCatalogName(1));
                ;
                System.out.println("4. 列数据类型 :: " + resultSetMetaData.getColumnTypeName(1));
                System.out.println("5. 表名 :: " + resultSetMetaData.getTableName(1));
            } catch (SQLException e) {
                printSQLException(e);
            }
        }
    
        public static void printSQLException(SQLException ex) {
            for (Throwable e : ex) {
                if (e instanceof SQLException) {
                    if (!ignoreSQLException(((SQLException) e).getSQLState())) {
                        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!");
                return false;
            }
    
            // X0Y32: Jar文件已存在
            if (sqlState.equalsIgnoreCase("X0Y32"))
                return true;
    
            // 42Y55: 该表已存在
            if (sqlState.equalsIgnoreCase("42Y55"))
                return true;
            return false;
        }

输出结果如下：

java.sql.SQLSyntaxErrorException: You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near '=1' at line 1
    	at com.mysql.cj.jdbc.exceptions.SQLError.createSQLException(SQLError.java:120)
    	at com.mysql.cj.jdbc.exceptions.SQLError.createSQLException(SQLError.java:97)
    	at com.mysql.cj.jdbc.exceptions.SQLExceptionsMapping.translateException(SQLExceptionsMapping.java:122)
    	at com.mysql.cj.jdbc.StatementImpl.executeQuery(StatementImpl.java:1218)
    	at com.lkf.jdbc.SQLExceptionDemo.main(SQLExceptionDemo.java:13)
    SQLState: 42000
    Error Code: 1064
    Message: You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near '=1' at line 1

## 3、警告（Warnings） ##

SQLWarning 对象是SQLException的子类，用于处理数据库访问警告。 警告不会像异常一样终止应用程序的执行。 它们只是警告用户某些事情没有按计划进行。

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTA2NDcwMzU_size_16_color_FFFFFF_t_70 1]

以下方法说明了如何获取有关Statement或ResultSet对象上报告的所有警告的完整信息：

public static void getWarningsFromResultSet(ResultSet rs)
                throws SQLException {
            printWarnings(rs.getWarnings());
        }
    
        public static void getWarningsFromStatement(Statement stmt)
                throws SQLException {
            printWarnings(stmt.getWarnings());
        }
    
        public static void printWarnings(SQLWarning warning)
                throws SQLException {
    
            if (warning != null) {
                System.out.println("\n---Warning---\n");
    
                while (warning != null) {
                    System.out.println("Message: " + warning.getMessage());
                    System.out.println("SQLState: " + warning.getSQLState());
                    System.out.print("Vendor error code: ");
                    System.out.println(warning.getErrorCode());
                    System.out.println("");
                    warning = warning.getNextWarning();
                }
            }
        }

最常见的警告是DataTruncation警告，它是SQLWarning的子类。 所有DataTruncation对象的SQLState均为01004，表示读取或写入数据有问题。

使用DataTruncation方法，您可以找出在哪个列或参数数据中被截断，截断是在读取还是写入操作上进行的，应该传送多少字节以及实际传送了多少字节。

## 4、SQLException 分类 ##

JDBC驱动程序可能会抛出SQLException的子类，该子类对应于与特定SQLState类值不相关的常见SQLState或常见错误状态。 这使我们可以编写更多可移植的错误处理代码。 这些异常是以下类别之一的子类：

*  SQLNonTransientException
 *  SQLTransientException
 *  SQLRecoverableException

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTA2NDcwMzU_size_16_color_FFFFFF_t_70 2]

## 5、SQLException的其他子类 ##

**BatchUpdateException**

在批处理更新操作期间发生错误时，将引发BatchUpdateException。 除了SQLException提供的信息外，BatchUpdateException还提供错误发生之前已执行的所有语句的更新计数。

**SQLClientInfoException**

无法在连接上设置一个或多个客户端信息属性时，将引发SQLClientInfoException。 除了SQLException提供的信息外，SQLClientInfoException还提供未设置的客户端信息属性的列表。

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTA2NDcwMzU_size_16_color_FFFFFF_t_70]: https://img-blog.csdnimg.cn/20191215172153915.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTA2NDcwMzU=,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTA2NDcwMzU_size_16_color_FFFFFF_t_70 1]: https://img-blog.csdnimg.cn/2019121517413120.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTA2NDcwMzU=,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTA2NDcwMzU_size_16_color_FFFFFF_t_70 2]: https://img-blog.csdnimg.cn/20191215174413213.PNG?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTA2NDcwMzU=,size_16,color_FFFFFF,t_70