cn.hutool.db.sql

类 SqlExecutor

java.lang.Object

cn.hutool.db.sql.SqlExecutor

public class SqlExecutor
extends Object

SQL执行器，全部为静态方法，执行查询或非查询的SQL语句
此方法为JDBC的简单封装，与数据库类型无关

作者:

loolly

构造器概要

构造器

构造器和说明
SqlExecutor()

方法概要

方法

限定符和类型	方法和说明
static boolean	call(Connection conn, String sql, Object... params) 执行调用存储过程 此方法不会关闭Connection
static ResultSet	callQuery(Connection conn, String sql, Object... params) 执行调用存储过程 此方法不会关闭Connection
static int	execute(Connection conn, String sql, Map<String,Object> paramMap) 执行非查询语句 语句包括 插入、更新、删除 此方法不会关闭Connection
static int	execute(Connection conn, String sql, Object... params) 执行非查询语句 语句包括 插入、更新、删除 此方法不会关闭Connection
static boolean	execute(PreparedStatement ps, Object... params) 可用于执行任何SQL语句，返回一个boolean值，表明执行该SQL语句是否返回了ResultSet。
static int[]	executeBatch(Connection conn, Iterable<String> sqls) 批量执行非查询语句 语句包括 插入、更新、删除 此方法不会关闭Connection
static int[]	executeBatch(Connection conn, String... sqls) 批量执行非查询语句 语句包括 插入、更新、删除 此方法不会关闭Connection
static int[]	executeBatch(Connection conn, String sql, Iterable<Object[]> paramsBatch) 批量执行非查询语句 语句包括 插入、更新、删除 此方法不会关闭Connection
static int[]	executeBatch(Connection conn, String sql, Object[]... paramsBatch) 批量执行非查询语句 语句包括 插入、更新、删除 此方法不会关闭Connection
static Long	executeForGeneratedKey(Connection conn, String sql, Map<String,Object> paramMap) 执行非查询语句，返回主键 发查询语句包括 插入、更新、删除 此方法不会关闭Connection
static Long	executeForGeneratedKey(Connection conn, String sql, Object... params) 执行非查询语句，返回主键 发查询语句包括 插入、更新、删除 此方法不会关闭Connection
static int	executeUpdate(PreparedStatement ps, Object... params) 用于执行 INSERT、UPDATE 或 DELETE 语句以及 SQL DDL（数据定义语言）语句，例如 CREATE TABLE 和 DROP TABLE。
static <T> T	query(Connection conn, String sql, RsHandler<T> rsh, Map<String,Object> paramMap) 执行查询语句 此方法不会关闭Connection
static <T> T	query(Connection conn, String sql, RsHandler<T> rsh, Object... params) 执行查询语句 此方法不会关闭Connection
static <T> T	query(PreparedStatement ps, RsHandler<T> rsh, Object... params) 执行查询语句 此方法不会关闭PreparedStatement
static <T> T	queryAndClosePs(PreparedStatement ps, RsHandler<T> rsh, Object... params) 执行查询语句并关闭PreparedStatement

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

SqlExecutor

public SqlExecutor()

方法详细资料

execute

public static int execute(Connection conn,
          String sql,
          Map<String,Object> paramMap)
                   throws SQLException

执行非查询语句
语句包括 插入、更新、删除
此方法不会关闭Connection

参数:

conn - 数据库连接对象

sql - SQL，使用name做为占位符，例如:name

paramMap - 参数Map

返回:

影响的行数

抛出:

SQLException - SQL执行异常

从以下版本开始:

4.0.10

execute

public static int execute(Connection conn,
          String sql,
          Object... params)
                   throws SQLException

执行非查询语句
语句包括 插入、更新、删除
此方法不会关闭Connection

参数:

conn - 数据库连接对象

sql - SQL

params - 参数

返回:

影响的行数

抛出:

SQLException - SQL执行异常

call

public static boolean call(Connection conn,
           String sql,
           Object... params)
                    throws SQLException

执行调用存储过程
此方法不会关闭Connection

参数:

conn - 数据库连接对象

sql - SQL

params - 参数

返回:

如果执行后第一个结果是ResultSet，则返回true，否则返回false。

抛出:

SQLException - SQL执行异常

callQuery

public static ResultSet callQuery(Connection conn,
                  String sql,
                  Object... params)
                           throws SQLException

执行调用存储过程
此方法不会关闭Connection

参数:

conn - 数据库连接对象

sql - SQL

params - 参数

返回:

ResultSet

抛出:

SQLException - SQL执行异常

从以下版本开始:

4.1.4

executeForGeneratedKey

public static Long executeForGeneratedKey(Connection conn,
                          String sql,
                          Map<String,Object> paramMap)
                                   throws SQLException

执行非查询语句，返回主键
发查询语句包括 插入、更新、删除
此方法不会关闭Connection

参数:

conn - 数据库连接对象

sql - SQL

paramMap - 参数Map

返回:

主键

抛出:

SQLException - SQL执行异常

从以下版本开始:

4.0.10

executeForGeneratedKey

public static Long executeForGeneratedKey(Connection conn,
                          String sql,
                          Object... params)
                                   throws SQLException

执行非查询语句，返回主键
发查询语句包括 插入、更新、删除
此方法不会关闭Connection

参数:

conn - 数据库连接对象

sql - SQL

params - 参数

返回:

主键

抛出:

SQLException - SQL执行异常

executeBatch

public static int[] executeBatch(Connection conn,
                 String sql,
                 Object[]... paramsBatch)
                          throws SQLException

批量执行非查询语句
语句包括 插入、更新、删除
此方法不会关闭Connection

参数:

conn - 数据库连接对象

sql - SQL

paramsBatch - 批量的参数

返回:

每个SQL执行影响的行数

抛出:

SQLException - SQL执行异常

executeBatch

public static int[] executeBatch(Connection conn,
                 String sql,
                 Iterable<Object[]> paramsBatch)
                          throws SQLException

批量执行非查询语句
语句包括 插入、更新、删除
此方法不会关闭Connection

参数:

conn - 数据库连接对象

sql - SQL

paramsBatch - 批量的参数

返回:

每个SQL执行影响的行数

抛出:

SQLException - SQL执行异常

executeBatch

public static int[] executeBatch(Connection conn,
                 String... sqls)
                          throws SQLException

批量执行非查询语句
语句包括 插入、更新、删除
此方法不会关闭Connection

参数:

conn - 数据库连接对象

sqls - SQL列表

返回:

每个SQL执行影响的行数

抛出:

SQLException - SQL执行异常

从以下版本开始:

4.5.6

executeBatch

public static int[] executeBatch(Connection conn,
                 Iterable<String> sqls)
                          throws SQLException

批量执行非查询语句
语句包括 插入、更新、删除
此方法不会关闭Connection

参数:

conn - 数据库连接对象

sqls - SQL列表

返回:

每个SQL执行影响的行数

抛出:

SQLException - SQL执行异常

从以下版本开始:

4.5.6

query

public static <T> T query(Connection conn,
          String sql,
          RsHandler<T> rsh,
          Map<String,Object> paramMap)
               throws SQLException

执行查询语句
此方法不会关闭Connection

类型参数:

T - 处理结果类型

参数:

conn - 数据库连接对象

sql - 查询语句，使用参数名占位符，例如:name

rsh - 结果集处理对象

paramMap - 参数对

返回:

结果对象

抛出:

SQLException - SQL执行异常

从以下版本开始:

4.0.10

query

public static <T> T query(Connection conn,
          String sql,
          RsHandler<T> rsh,
          Object... params)
               throws SQLException

执行查询语句
此方法不会关闭Connection

类型参数:

T - 处理结果类型

参数:

conn - 数据库连接对象

sql - 查询语句

rsh - 结果集处理对象

params - 参数

返回:

结果对象

抛出:

SQLException - SQL执行异常

executeUpdate

public static int executeUpdate(PreparedStatement ps,
                Object... params)
                         throws SQLException

用于执行 INSERT、UPDATE 或 DELETE 语句以及 SQL DDL（数据定义语言）语句，例如 CREATE TABLE 和 DROP TABLE。
INSERT、UPDATE 或 DELETE 语句的效果是修改表中零行或多行中的一列或多列。
executeUpdate 的返回值是一个整数（int），指示受影响的行数（即更新计数）。
对于 CREATE TABLE 或 DROP TABLE 等不操作行的语句，executeUpdate 的返回值总为零。
此方法不会关闭PreparedStatement

参数:

ps - PreparedStatement对象

params - 参数

返回:

影响的行数

抛出:

SQLException - SQL执行异常

execute

public static boolean execute(PreparedStatement ps,
              Object... params)
                       throws SQLException

可用于执行任何SQL语句，返回一个boolean值，表明执行该SQL语句是否返回了ResultSet。
如果执行后第一个结果是ResultSet，则返回true，否则返回false。
此方法不会关闭PreparedStatement

参数:

ps - PreparedStatement对象

params - 参数

返回:

如果执行后第一个结果是ResultSet，则返回true，否则返回false。

抛出:

SQLException - SQL执行异常

query

public static <T> T query(PreparedStatement ps,
          RsHandler<T> rsh,
          Object... params)
               throws SQLException

执行查询语句
此方法不会关闭PreparedStatement

类型参数:

T - 处理结果类型

参数:

ps - PreparedStatement

rsh - 结果集处理对象

params - 参数

返回:

结果对象

抛出:

SQLException - SQL执行异常

queryAndClosePs

public static <T> T queryAndClosePs(PreparedStatement ps,
                    RsHandler<T> rsh,
                    Object... params)
                         throws SQLException

执行查询语句并关闭PreparedStatement

类型参数:

T - 处理结果类型

参数:

ps - PreparedStatement

rsh - 结果集处理对象

params - 参数

返回:

结果对象

抛出:

SQLException - SQL执行异常