Statement 对象用于执行 SQL 语句并获取结果。JDBC API 提供了三种语句接口:

  • Statement — 用于执行不带参数的简单 SQL 语句
  • PreparedStatement — 用于执行带或不带 IN 参数的预编译 SQL 语句
  • CallableStatement — 用于执行存储过程调用

13.1 Statement 接口

Statement 接口是执行 SQL 语句的基本接口。

13.1.1 创建语句

通过 Connection.createStatement() 方法可以创建 Statement 对象。

1
Statement stmt = con.createStatement();

13.1.1.1 设置 ResultSet 特性

调用 createStatement 时,可以通过参数指定返回结果集的类型、并发模式和保持性。

1
2
3
4
Statement stmt = con.createStatement(
ResultSet.TYPE_SCROLL_INSENSITIVE,
ResultSet.CONCUR_UPDATABLE
);

13.1.2 执行 Statement 对象

13.1.2.1 返回 ResultSet 对象

executeQuery 方法用于执行返回 ResultSet 的 SQL 查询。

1
ResultSet rs = stmt.executeQuery("SELECT * FROM employees");

13.1.2.2 返回更新计数

executeUpdate 方法用于执行 DML 语句(INSERT、UPDATE、DELETE)和 DDL 语句。

1
int updateCount = stmt.executeUpdate("DELETE FROM employees WHERE id = 100");

13.1.2.3 返回未知或多个结果

如果语句可能返回多个结果,或者事先无法确定结果类型,可以使用 execute 方法执行。

1
2
3
4
5
6
boolean isResultSet = stmt.execute(sql);
if (isResultSet) {
ResultSet rs = stmt.getResultSet();
} else {
int updateCount = stmt.getUpdateCount();
}

13.1.3 限制 Statement 对象的执行时间

Statement 接口支持设置查询超时时间。

1
stmt.setQueryTimeout(10); // 10 seconds

13.1.4 关闭 Statement 对象

应用程序使用完 Statement 对象后,应当将其关闭,释放相关资源。

1
stmt.close();
赞助商

13.2 PreparedStatement 接口

PreparedStatement 继承了 Statement 接口,并提供设置参数的功能。

13.2.1 创建 PreparedStatement 对象

通过 Connection.prepareStatement() 方法可以创建 PreparedStatement 对象。

1
2
3
PreparedStatement pstmt = con.prepareStatement(
"SELECT * FROM employees WHERE department_id = ?"
);

13.2.1.1 设置 ResultSet 特性

与创建 Statement 类似,创建 PreparedStatement 时也可以指定结果集的特性。

13.2.2 设置参数

PreparedStatement 通过不同的 setXXX 方法设置参数值。

13.2.2.1 类型转换

JDBC 定义了从 Java 类型到 SQL 类型的标准映射。

13.2.2.2 国家字符集转换

setNString、setNClob 等方法用于处理国家字符集数据。

13.2.2.3 使用 setObject 方法进行类型转换

setObject 方法可以将任意 Java 对象转换为适当的 SQL 类型。

1
pstmt.setObject(1, myObject, Types.VARCHAR);

13.2.2.4 设置 NULL 参数

setNull 方法用于将参数设置为 SQL NULL。

1
pstmt.setNull(1, Types.VARCHAR);

13.2.2.5 清除参数

clearParameters 方法清除所有参数值。

1
pstmt.clearParameters();

13.2.3 执行 PreparedStatement 对象

PreparedStatement 对象使用 executeQuery、executeUpdate 或 execute 方法执行。

13.3 CallableStatement 接口

CallableStatement 继承了 PreparedStatement 接口,并增加了对存储过程调用的支持。

13.3.1 创建 CallableStatement 对象

通过 Connection.prepareCall() 方法可以创建 CallableStatement 对象。

1
CallableStatement cstmt = con.prepareCall("{call getEmployee(?, ?)}");

13.3.2 设置参数

13.3.2.1 IN 参数

IN 参数使用与 PreparedStatement 相同的 setXXX 方法设置。

13.3.2.2 OUT 参数

OUT 参数必须使用 registerOutParameter 方法注册。

1
cstmt.registerOutParameter(2, Types.VARCHAR);

13.3.2.3 INOUT 参数

对于 INOUT 参数,既需要设置输入值,也需要注册输出类型。

1
2
cstmt.setString(1, "input");
cstmt.registerOutParameter(1, Types.VARCHAR);

13.3.2.4 清除参数

clearParameters 方法清除所有参数值。

13.3.3 执行 CallableStatement 对象

13.3.3.1 返回单个 ResultSet 对象

13.3.3.2 返回更新计数

13.3.3.3 返回未知或多个结果

13.3.3.4 REF CURSOR 支持

JDBC 4.2 添加了对 REF CURSOR 数据类型的支持。

13.4 转义语法

JDBC 通过转义语法,使应用程序能够以不依赖特定数据库的方式表达相关操作。

13.4.1 标量函数

1
{fn scalar_function}

13.4.2 日期和时间字面量

1
2
3
{d 'yyyy-mm-dd'}
{t 'hh:mm:ss'}
{ts 'yyyy-mm-dd hh:mm:ss.f...'}

13.4.3 外连接

1
{oj outer-join}

13.4.4 存储过程和函数

1
2
{call procedure_name(?, ...)}
{? = call function_name(?, ...)}

13.4.5 LIKE 转义字符

1
{escape 'escape-character'}

13.4.6 限制返回行

1
LIMIT rows

13.5 获取自动生成的值

JDBC 提供了获取自动生成键的机制。

1
2
3
Statement stmt = con.createStatement();
stmt.execute(insertSQL, Statement.RETURN_GENERATED_KEYS);
ResultSet rs = stmt.getGeneratedKeys();