Java java.sql 接口 Statement（JDK5）

所有类

概述  软件包   类  使用  树  已过时  索引  帮助
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

java.sql
接口 Statement

所有已知子接口：

CallableStatement, PreparedStatement

---

public interface Statement

用于执行静态 SQL 语句并返回它所生成结果的对象。

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

另请参见：

Connection.createStatement(), ResultSet

---

字段摘要
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 语句，该语句可能返回多个结果。
boolean	execute(String sql, int autoGeneratedKeys)           执行给定的 SQL 语句（该语句可能返回多个结果），并通知驱动程序所有自动生成的键都应该可用于检索。
boolean	execute(String sql, int[] columnIndexes)           执行给定的 SQL 语句（该语句可能返回多个结果），并通知驱动程序在给定数组中指示的自动生成的键应该可用于检索。
boolean	execute(String sql, String[] columnNames)           执行给定的 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 对象上的调用报告的第一个警告。
void	setCursorName(String name)           将 SQL 指针名称设置为给定的 String，后续 Statement 对象的 execute 方法将使用此字符串。
void	setEscapeProcessing(boolean enable)           将转义处理设置为开或关。
void	setFetchDirection(int direction)           向驱动程序提供关于方向的提示，在使用此 Statement 对象创建的 ResultSet 对象中将按该方向处理行。
void	setFetchSize(int rows)           为 JDBC 驱动程序提供关于需要更多行时应该从数据库获取的行数的提示。
void	setMaxFieldSize(int max)           设置将字符或二进制值存储到给定字节数中 ResultSet 列中的最大字节数限制。
void	setMaxRows(int max)           将任何 ResultSet 对象都可以包含的最大行数限制设置为给定数。
void	setQueryTimeout(int seconds)           将驱动程序等待 Statement 对象执行的秒数设置为给定秒数。

 

字段详细信息

CLOSE_CURRENT_RESULT

static final int CLOSE_CURRENT_RESULT

该常量指示调用 getMoreResults 时应该关闭当前 ResultSet 对象。

从以下版本开始：

1.4

另请参见：

常量字段值

---

KEEP_CURRENT_RESULT

static final int KEEP_CURRENT_RESULT

该常量指示调用 getMoreResults 时应该关闭当前 ResultSet 对象。

从以下版本开始：

1.4

另请参见：

常量字段值

---

CLOSE_ALL_RESULTS

static final int CLOSE_ALL_RESULTS

该常量指示调用 getMoreResults 时应该关闭以前一直打开的所有 ResultSet 对象。

从以下版本开始：

1.4

另请参见：

常量字段值

---

SUCCESS_NO_INFO

static final int SUCCESS_NO_INFO

该常量指示批量语句执行成功但不存在受影响的可用行数计数。

从以下版本开始：

1.4

另请参见：

常量字段值

---

EXECUTE_FAILED

static final int EXECUTE_FAILED

该常量指示在执行批量语句时发生错误。

从以下版本开始：

1.4

另请参见：

常量字段值

---

RETURN_GENERATED_KEYS

static final int RETURN_GENERATED_KEYS

该常量指示生成的键应该可用于检索。

从以下版本开始：

1.4

另请参见：

常量字段值

---

NO_GENERATED_KEYS

static final int NO_GENERATED_KEYS

该常量指示生成的键应该不可用于检索。

从以下版本开始：

1.4

另请参见：

常量字段值

方法详细信息

executeQuery

ResultSet executeQuery(String sql)
                       throws SQLException

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

参数：

sql - 要发送给数据库的 SQL 语句，通常为静态 SQL SELECT 语句

返回：

包含给定查询所生成数据的 ResultSet 对象；永远不能为 null

抛出：

SQLException - 如果发生数据库访问错误或者给定 SQL 语句生成单个 ResultSet 对象之外的任何其他内容