Statement 是
Java 执行
数据库操作的一个重要接口,用于在已经建立数据库连接的基础上,向数据库发送要执行的SQL语句。Statement对象,用于执行不带参数的简单SQL语句。
接口定义
---Wrapper接口是一系列方法的声明,是一些方法的特征的集合
子接口
CallableStatement, PreparedStatement
说明
用于执行静态
SQL 语句并返回它所生成结果的对象。
在默认情况下,同一时间每个 Statement 对象在只能打开一个 ResultSet 对象。因此,如果读取一个 ResultSet 对象与读取另一个交叉,则这两个对象必须是由不同的 Statement 对象生成的。如果存在某个语句的打开的当前 ResultSet 对象,则 Statement 接口中的所有执行方法都会隐式关闭它。
Statement 对象用于将 SQL 语句发送到数据库中。实际上有三种 Statement 对象,它们都作为在给定连接上执行 SQL 语句的包容器:Statement、PreparedStatement(它从 Statement 继承而来)和 CallableStatement(它从 PreparedStatement 继承而来)。它们都专用于发送特定类型的 SQL 语句: Statement 对象用于执行不带参数的简单 SQL 语句;PreparedStatement 对象用于执行带或不带 IN 参数的预编译 SQL 语句;CallableStatement 对象用于执行对数据库已存在的
存储过程的调用。
Statement 接口提供了
执行语句和获取结果的基本方法。PreparedStatement 接口添加了处理 IN 参数的方法;而 CallableStatement 添加了处理 OUT 参数的方法。
有些 DBMS 将已
存储过程中的每条语句视为独立的语句;而另外一些则将整个过程视为一个
复合语句。在启用自动提交时,这种差别就变得非常重要,因为它影响什么时候调用 commit 方法。在前一种情况中,每条语句单独提交;在后一种情况中,所有语句同时提交。
摘要
字段摘要
static int CLOSE_ALL_RESULTS
该常量指示调用 getMoreResults 时应该关闭以前一直打开的所有
ResultSet 对象。
static int CLOSE_CURRENT_RESULT
该常量指示调用 getMoreResults 时应该关闭当前 ResultSet 对象。
static int EXECUTE_FAILED
该常量指示在执行批量语句时发生错误。
static int KEEP_CURRENT_RESULT
该常量指示调用 getMoreResults 时不会关闭当前 ResultSet 对象。
static int NO_GENERATED_KEYS
该常量指示生成的键应该不可用于获取。
static int RETURN_GENERATED_KEYS
该常量指示生成的键应该可用于获取。
static int SUCCESS_NO_INFO
该常量指示批量语句执行成功但不存在受影响的可用行数计数。
方法摘要
void addBatch(String
sql)
将给定的 SQL 命令添加到此 Statement 对象的当前命令列表中。
void cancel()
如果 DBMS 和
驱动程序都支持中止 SQL 语句,则取消此 Statement 对象。
void clearBatch()
清空此 Statement 对象的当前 SQL 命令列表。
void clearWarnings()
清除在此 Statement 对象上报告的所有警告。
void close()
立即释放此 Statement 对象的数据库和 JDBC 资源,而不是等待该对象自动关闭时发生此操作。
boolean
execute(String sql)
执行给定的 SQL 语句,该语句在返回一个
布尔值时用于反映SQL语句是否执行成功。
boolean execute(String sql, int autoGeneratedKeys)
执行给定的 SQL 语句(该语句返回一个布尔值用于反映SQL语句是否成功执行),并通知驱动程序所有自动生成的键都应该可用于获取。
boolean execute(String sql, int[] columnIndexes)
执行给定的 SQL 语句,(该语句返回一个布尔值用于反映SQL语句是否执行成功),并通知驱动程序在给定数组中指示的自动生成的键应可用获取。
boolean execute(String sql, String[] columnNames)
执行给定的 SQL 语句,该语句返回一个布尔值用于反映SQL语句是否成功执行,并通知驱动程序在给定数组中指示的自动生成的键用于获取。
int[] executeBatch()
将一批命令提交给数据库来执行,如果全部命令执行成功,则返回更新
计数组成的数组。
ResultSet executeQuery(String sql)
执行给定的 SQL 语句,该语句返回单个 ResultSet 对象。
int executeUpdate(String sql)
执行给定 SQL 语句,该语句可能为 INSERT、UPDATE 或 DELETE 语句,或者不返回任何内容的 SQL 语句(如 SQL DDL 语句)。
int executeUpdate(String sql, int autoGeneratedKeys)
执行给定的 SQL 语句,并用给定标志通知
驱动程序由此 Statement 生成的自动生成键是否可用于获取。
int executeUpdate(String sql, int[] columnIndexes)
执行给定的 SQL 语句,并通知驱动程序在给定数组中指示的自动生成的键可用于获取。
int executeUpdate(String sql, String[] columnNames)
执行给定的 SQL 语句,通知驱动程序在给定数组中指示的自动生成的键可用于获取。
Connection getConnection()
获取生成此 Statement 对象的 Connection 对象。
int getFetchDirection()
获取从数据库表获取行的方向,该方向是根据此 Statement 对象生成的结果集合的
默认值。
int getFetchSize()
获取结果集合的行数,该数是根据此 Statement 对象生成的 ResultSet 对象的默认获取大小。
ResultSet getGeneratedKeys()
获取由于执行此 Statement 对象而创建的所有自动生成的键。
int getMaxFieldSize()
获取可以为此 Statement 对象所生成 ResultSet 对象中的字符和
二进制列值返回的最大字节数。
int getMaxRows()
获取由此 Statement 对象生成的 ResultSet 对象可以包含的最大行数。
boolean getMoreResults()
移动到此 Statement 对象的下一个结果,如果其为 ResultSet 对象,则返回 true,并隐式关闭利用方法 getResultSet 获取的所有当前 ResultSet 对象。
boolean getMoreResults(int current)
将此 Statement 对象移动到下一个结果,根据给定标志指定的指令处理所有当前 ResultSet 对象;如果下一个结果为 ResultSet 对象,则返回 true。
int getQueryTimeout()
获取驱动程序等待 Statement 对象执行的秒数。
ResultSet getResultSet()
以 ResultSet 对象的形式获取当前结果。
int getResultSetConcurrency()
获取此 Statement 对象生成的 ResultSet 对象的
结果集合并发性。
int getResultSetHoldability()
获取此 Statement 对象生成的 ResultSet 对象的结果集合可保存性。
int getResultSetType()
获取此 Statement 对象生成的 ResultSet 对象的结果集合类型。
int getUpdateCount()
以更新计数的形式获取当前结果;如果结果为 ResultSet 对象或没有更多结果,则返回 -1。
SQLWarning getWarnings()
获取此 Statement 对象上的调用报告的第一个警告。
boolean isClosed()
获取是否已关闭了此 Statement 对象。
boolean isPoolable()
返回指示 Statement 是否是可池化的值。
void setCursorName(String name)
将 SQL指针名称设置为给定的 String,后续 Statement 对象的 execute 方法将使用此
字符串。
void setEscapeProcessing(boolean
enable)
将转义处理设置为开或关。
void setFetchDirection(int direction)
向
驱动程序提供关于方向的提示,在使用此 Statement 对象创建的 ResultSet 对象中将按该方向处理行。
void setFetchSize(int rows)
为
JDBC驱动程序提供一个提示,它提示此 Statement 生成的 ResultSet 对象需要更多行时应该从数据库获取的行数。
void setMaxFieldSize(int max)
设置此 Statement 对象生成的 ResultSet 对象中字符和二进制列值可以返回的最大字节数限制。
void setMaxRows(int max)
将此 Statement 对象生成的所有 ResultSet 对象可以包含的最大行数限制设置为给定数。
void setPoolable(boolean poolable)
请求将 Statement 池化或非池化。
void setQueryTimeout(int seconds)
将驱动程序等待 Statement 对象执行的秒数设置为给定秒数。
使用案例
1、创建 Statement 对象
建立了到特定数据库的连接之后,就可用该连接发送 SQL 语句。Statement 对象用 Connection 的方法 createStatement 创建,如下列
代码段中所示:
Connection con =
DriverManagerStatement stmt = con.createStatement();
为了执行 Statement 对象,被发送到数据库的 SQL 语句将
被作为参数提供给 Statement 的方法:
2、使用 Statement 对象执行语句
Statement 接口提供了三种执行 SQL 语句的方法:executeQuery、executeUpdate 和 execute。使用哪一个方法由 SQL 语句所产生的内容决定。
方法 executeQuery 用于产生单个
结果集的语句,例如 SELECT 语句。
方法 executeUpdate 用于执行 INSERT、UPDATE 或 DELETE 语句以及 SQL DDL(
数据定义语言)语句,例如 CREATE TABLE 和 DROP TABLE。INSERT、UPDATE 或 DELETE 语句的效果是修改表中零行或多行中的一列或多列。executeUpdate 的
返回值是一个整数,指示受影响的行数(即更新计数)。对于 CREATE TABLE 或 DROP TABLE 等不操作行的语句,executeUpdate 的返回值总为零。
方法 execute 用于执行返回多个
结果集、多个更新计数或二者组合的语句。因为多数程序员不会需要该高级功能,所以本概述后面将在单独一节中对其进行介绍。
执行语句的所有方法都将关闭所调用的 Statement 对象的当前打开结果集(如果存在)。这意味着在
重新执行 Statement 对象之前,需要完成对当前 ResultSet 对象的处理。
应注意,继承了 Statement 接口中所有方法的 PreparedStatement 接口都有自己的 executeQuery、executeUpdate 和 execute 方法。Statement 对象本身不包含 SQL 语句,因而必须给 Statement.execute 方法提供 SQL 语句作为参数。PreparedStatement 对象并不将 SQL 语句作为参数提供给这些方法,因为它们已经包含
预编译SQL 语句。CallableStatement 对象继承这些方法的 PreparedStatement 形式。对于这些方法的 PreparedStatement 或 CallableStatement 版本,使用
查询参数将抛出 SQLException。
3、语句完成
当连接处于自动提交模式时,其中所执行的语句在完成时将自动提交或还原。语句在已执行且所有结果返回时,即认为已完成。对于返回一个
结果集的 executeQuery 方法,在检索完 ResultSet 对象的所有行时该语句完成。对于方法 executeUpdate,当它执行时语句即完成。但在少数调用方法 execute 的情况中,在检索所有结果集或它生成的更新计数之后语句才完成。
关闭 Statement 对象
Statement 对象将由
Java 垃圾收集程序自动关闭。而作为一种好的编程风格,应在不需要 Statement 对象时显式地关闭它们。这将立即释放 DBMS 资源,有助于避免潜在的内存问题。