JDBC API 4.2（五）：Statement 接口源码分析

约定不等于承诺〃 2023-06-13 13:26 14阅读 0赞

> 在本文中，我们将通过示例学习常用的JDBC Statement接口方法。  
> 
> 
> ### 文章目录 ###
> 
>  *   *  1、简述
>      *  2、Statement 类图
>      *  3、Statement 接口常用方法
>      *   *  3.1、boolean execute(String sql) throws SQLException
>          *  3.2、boolean execute(String sql,int autoGeneratedKeys) throws SQLException
>          *  3.3、boolean execute(String sql,int\[\] columnIndexes) throws SQLException
>          *  3.4、boolean execute(String sql,String\[\] columnNames) throws SQLException
>          *  3.5、int\[\] executeBatch() throws SQLException
>          *  3.6、ResultSet executeQuery(String sql) throws SQLException
>          *  3.7、int executeUpdate(String sql) throws SQLException
>          *  3.8、int executeUpdate(String sql,int autoGeneratedKeys) throws SQLException
>          *  3.9、int executeUpdate(String sql,int\[\] columnIndexes) throws SQLException
>          *  3.10、int executeUpdate(String sql,String\[\] columnNames) throws SQLException
>      *  4、Statement 接口示例

## 1、简述 ##

Statement 用于执行静态SQL语句并返回其产生的结果的对象。

默认情况下，每个Statement对象只能同时打开一个ResultSet对象。 因此，如果一个ResultSet对象的读取与另一个对象的读取是交错的，则每个都必须由不同的Statement对象生成。 如果存在打开的语句，Statement接口中的所有执行方法都会隐式关闭该语句的当前ResultSet对象。

## 2、Statement 类图 ##

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

## 3、Statement 接口常用方法 ##

### 3.1、boolean execute(String sql) throws SQLException ###

执行给定的SQL语句，该语句可能返回多个结果。 在某些（不常见）情况下，单个SQL语句可能返回多个结果集。 通常，除非您（1）执行您知道可能会返回多个结果的存储过程，或者（2）您正在动态执行未知的SQL字符串，否则您可以忽略此设置。

> 注意：不能在PreparedStatement或CallableStatement上调用此方法。

### 3.2、boolean execute(String sql,int autoGeneratedKeys) throws SQLException ###

执行给定的SQL语句，该语句可能返回多个结果，并向驱动程序发出信号，告知应自动生成键。 如果SQL语句不是INSERT语句，或者不是能够返回自动生成的键的SQL语句，驱动程序将忽略此信号。

在某些（不常见）情况下，单个SQL语句可能返回多个结果集。 通常，除非您（1）执行您知道可能会返回多个结果的存储过程，或者（2）您正在动态执行未知的SQL字符串，否则您可以忽略此设置。

**autoGeneratedKeys：** 一个常量，指示是否应使用getGeneratedKeys方法自动生成键；

### 3.3、boolean execute(String sql,int\[\] columnIndexes) throws SQLException ###

执行给定的SQL语句，该语句可能返回多个结果，并向驱动程序发出信号，使用给定数组中指示的自动生成的键用于检索。 该数组包含目标表中各列的索引，这些列包含应提供的自动生成的键。 如果SQL语句不是INSERT语句，或者不是能够返回自动生成的键的SQL语句，驱动程序将忽略该数组。

> 注意：不能在PreparedStatement或CallableStatement上调用此方法。

**columnIndexes：** 插入行中列索引的数组，应该通过调用方法getGeneratedKeys使它们可供检索

### 3.4、boolean execute(String sql,String\[\] columnNames) throws SQLException ###

执行给定的SQL语句，该语句可能返回多个结果，并向驱动程序发出信号，使给定数组中指示的自动生成的键可用于检索。 该数组包含目标表中包含自动生成的键的列的名称。 如果SQL语句不是INSERT语句，或者不是能够返回自动生成的键的SQL语句，驱动程序将忽略该数组。

**columnNames：** 插入行中各列名称的数组，应通过调用方法getGeneratedKeys使它们可供检索

> 注意：不能在PreparedStatement或CallableStatement上调用此方法。

### 3.5、int\[\] executeBatch() throws SQLException ###

将一批命令提交给数据库执行，如果所有命令都成功执行，则返回更新计数数组。 返回数组的int元素的顺序与批处理中的命令相对应，这些命令根据将它们添加到批处理中的顺序进行排序。

由executeBatch方法返回的数组中的元素可以是以下之一：

1、大于或等于零的数字,表示命令已成功处理，并且是更新计数，给出了数据库中受命令执行影响的行数

2、SUCCESS\_NO\_INFO 的值,表示命令已成功处理，但受影响的行数未知

如果批处理更新中的命令之一无法正确执行，则此方法将引发BatchUpdateException，并且JDBC驱动程序可能会或可能不会继续处理批处理中的其余命令。 但是，驱动程序的行为必须始终与特定的DBMS保持一致，要么始终继续处理命令，要么永远不继续处理命令。 如果驱动程序在失败后继续处理，则由BatchUpdateException.getUpdateCounts方法返回的数组将包含与批处理中的命令一样多的元素

3、EXECUTE\_FAILED 的值，表示命令执行失败，仅当驱动程序在命令失败后继续处理命令时才会发生

### 3.6、ResultSet executeQuery(String sql) throws SQLException ###

执行给定的SQL语句，该语句返回一个ResultSet对象。

> 注意：不能在PreparedStatement或CallableStatement上调用此方法。

### 3.7、int executeUpdate(String sql) throws SQLException ###

执行给定的SQL语句，该语句可以是INSERT，UPDATE或DELETE语句，也可以是不返回任何内容的SQL语句，例如SQL DDL语句。

> 注意：不能在PreparedStatement或CallableStatement上调用此方法。

### 3.8、int executeUpdate(String sql,int autoGeneratedKeys) throws SQLException ###

执行给定的SQL语句，并用给定的标志向驱动程序发出有关是否应使此Statement对象产生的自动生成的键可用于检索的信号。 如果SQL语句不是INSERT语句，或者不是能够返回自动生成的键的SQL语句，驱动程序将忽略该标志。

> 注意：不能在PreparedStatement或CallableStatement上调用此方法。

### 3.9、int executeUpdate(String sql,int\[\] columnIndexes) throws SQLException ###

执行给定的SQL语句并向驱动程序发送信号，使给定数组中指示的自动生成的键可用于检索。 该数组包含目标表中各列的索引，这些列包含应提供的自动生成的键。 如果SQL语句不是INSERT语句，或者不是能够返回自动生成的键的SQL语句，驱动程序将忽略该数组。

**columnIndexes：** 列索引数组，指示应从插入的行返回的列

> 注意：不能在PreparedStatement或CallableStatement上调用此方法。

### 3.10、int executeUpdate(String sql,String\[\] columnNames) throws SQLException ###

执行给定的SQL语句并向驱动程序发送信号，使给定数组中指示的自动生成的键可用于检索。 该数组包含目标表中包含自动生成的键的列的名称，这些键应使其可用。 如果SQL语句不是INSERT语句，或者不是能够返回自动生成的键的SQL语句，驱动程序将忽略该数组。

**sql：** SQL数据操作语言（DML）语句，例如INSERT，UPDATE或DELETE； 或不返回任何内容的SQL语句，例如DDL语句。  
**columnNames：** 插入行应返回的列名称的数组

> 注意：不能在PreparedStatement或CallableStatement上调用此方法。

## 4、Statement 接口示例 ##

在此示例中，我们将使用executeQuery（）方法通过JDBC Statement接口从数据库表中检索记录。

private static final String QUERY_SQL = "select id,name,email,country,password from Users";
    
        public static void main(String[] args) {
            // Step 1: 创建 Connection
            try (Connection conn = DriverManager.getConnection(
                    "jdbc:mysql://localhost:3306/lkf_db?useUnicode=true&characterEncoding=utf8&serverTimezone=GMT",
                    "root", "root");
    
                 // Step 2:创建 statement
                 Statement stmt = conn.createStatement();
    
                 // Step 3: 执行SQL
                 ResultSet rs = stmt.executeQuery(QUERY_SQL)) {
    
                // Step 4: 处理 ResultSet 结果集
                while (rs.next()) {
                    int id = rs.getInt("id");
                    String name = rs.getString("name");
                    String email = rs.getString("email");
                    String country = rs.getString("country");
                    String password = rs.getString("password");
                    System.out.println(id + "," + name + "," + email + "," + country + "," + password);
                }
            } catch (SQLException e) {
                printSQLException(e);
            }
            // Step 4: try-with-resource 语句将自动关闭连接。
        }
    
        public static void printSQLException(SQLException ex) {
            for (Throwable e: ex) {
                if (e instanceof SQLException) {
                    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();
                    }
                }
            }
        }

参考资料：

https://docs.oracle.com/javase/8/docs/api/java/sql/Statement.html

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTA2NDcwMzU_size_16_color_FFFFFF_t_70]: https://img-blog.csdnimg.cn/20191117152208644.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTA2NDcwMzU=,size_16,color_FFFFFF,t_70