SQLException类的重要方法有哪些？

阅读更多：MySQL 教程

引言

在Java开发过程中，我们常常需要处理数据库的操作。一旦涉及到复杂的SQL语句或其他问题时，就可能出现SQL异常——SQLException。 SQLException类表示访问数据库时发生的异常。在处理SQLException时，我们需要了解SQLException类的重要方法，本文将为您介绍一些重要的SQLException类的方法，并提供完整的代码示例。

常用方法介绍

getMessage()

getMessage()方法返回代表此异常的详细消息字符串。常见的SQLException错误信息有：SQL语法错误，连接错误，参数错误，表不存在等。可以使用getMessage()方法打印异常的详细消息，方便我们快速定位问题。

try {
    //一些数据库操作可能会引发 SQLException
} catch (SQLException e) { 
    System.out.println(e.getMessage());
}

getErrorCode()

getErrorCode()方法返回引起数据库异常的原因代码。通常，如果我们得到MySQL异常代码：1216，则代表外键约束。这个方法可以帮助我们了解SQLException错误的原因，以便更好地修复问题。

try {
    //一些数据库操作可能会引发 SQLException
} catch (SQLException e) { 
    System.out.println(e.getErrorCode());
}

getSQLState()

getSQLState()方法返回SQL状态字符串。SQL状态是由于访问数据库时发生的异常而产生的标准X/Open或SQL:2003代码。可以帮助我们确定恢复失败时的错误。

try {
    //一些数据库操作可能会引发 SQLException
} catch (SQLException e) { 
    System.out.println(e.getSQLState());
}

getNextException() 和 getWarnings()

getNextException()方法返回SQLException链表中的下一个异常。如果不清楚Exception的原因，该方法可以帮助我们找到异常链表的下一个元素。getWarnings()方法可以返回SQLWarning链表中的第一项，以此类推。

try {
    //一些数据库操作可能会引发 SQLException
} catch (SQLException e) { 
    SQLException nextException = e.getNextException();
    if(nextException!=null)
        System.out.println(nextException.getMessage());
}

printStackTrace()

printStackTrace()方法可以打印SQLException的完整堆栈跟踪。这样可以提示开发者，可以追踪引起异常的代码行，方便问题解决。

try {
    //一些数据库操作可能会引发 SQLException
} catch (SQLException e) { 
    e.printStackTrace();
}

代码示例

考虑一个简单的数据库查询操作。在这个操作中有两个异常处理机制。第一个异常处理机制用于错误的连接，而第二个异常机制用于不正确的SQL语句。

import java.sql.*;

public class SQLExceptionExample{

    public static void main(String[] args) {

        try {
            Class.forName("com.mysql.cj.jdbc.Driver");
            Connection connection = DriverManager.getConnection("jdbc:mysql://localhost:3306/test", "root", "123456");
            String sql = "SELECT * FROM users";
            Statement statement = connection.createStatement();
            ResultSet resultSet = statement.executeQuery(sql);

            while (resultSet.next()) {
                System.out.println("ID: " + resultSet.getInt("id")
                        + "\nName: " + resultSet.getString("name")
                        + "\nEmail: " + resultSet.getString("email"));
            }

            // close connections
            resultSet.close();
            statement.close();
            connection.close();

        } catch (ClassNotFoundException e) {
            System.out.println("JDBC driver not found");
        } catch (SQLException e) {
            System.out.println(e.getMessage());
            e.printStackTrace();
        }
    }
}

会发现如果连接到本地数据库时，代码将可以成功运行，否则将会打印SQLException错误，并进行堆跟踪。下面是运行代码所产生的错误日志：

JDBC driver not found

这是因为未能找到 MySQL JDBC 驱动程序。如果继续运行代码，则会引发另一个异常。下面是代码的修改后的代码：

import java.sql.*;

public class SQLExceptionExample{

    public static void main(String[] args) {

        try {
            Class.forName("com.mysql.cj.jdbc.Driver");
            Connection connection = DriverManager.getConnection("jdbc:mysql://localhost:3306/test", "root", "123456");
            String sql = "SELECT * FROM users WHERE age = ?";
            PreparedStatement preparedStatement = connection.prepareStatement(sql);
            preparedStatement.setInt(1, 20);
            ResultSet resultSet = preparedStatement.executeQuery();

            while (resultSet.next()) {
                System.out.println("ID: " + resultSet.getInt("id")
                        + "\nName: " + resultSet.getString("name")
                        + "\nEmail: " + resultSet.getString("email"));
            }

            // close connections
            resultSet.close();
            preparedStatement.close();
            connection.close();

        } catch (ClassNotFoundException e) {
            System.out.println("JDBC driver not found");
        } catch (SQLException e) {
            System.out.println(e.getMessage());
            e.printStackTrace();
        }
    }
}

在这个例子中，我们更改了 SQL 语句以包含 WHERE 子句，并为 Parameter 内容赋予了值。当我们运行代码时，它会发现找不到年龄列，因此会产生一个异常。下面输出的是异常日志：

Unknown column 'age' in 'where clause'
java.sql.SQLSyntaxErrorException: Unknown column 'age' in 'where clause'
    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.SQLError.createSQLException(SQLError.java:89)
    at com.mysql.cj.jdbc.exceptions.SQLError.createSQLException(SQLError.java:63)
    at com.mysql.cj.jdbc.exceptions.SQLError.createSQLException(SQLError.java:73)
    at com.mysql.cj.jdbc.StatementImpl.checkColumnForTable(StatementImpl.java:789)
    at com.mysql.cj.jdbc.StatementImpl.executeQuery(StatementImpl.java:1423)
    at SQLExceptionExample.main(SQLExceptionExample.java:16)

结论

在本文中，我们学习了SQLException类的一些重要方法。这些方法可以帮助我们查找和解决SQL异常，包括getMessage()，getErrorCode()，getSQLState()，getNextException()和getWarnings()，以及printStackTrace()。通过了解SQLException类的方法和使用代码示例，我们可以更加深入地理解在Java应用程序中处理数据库SQL异常的方法。