Java java.sql 接口 Statement（JDK5）

147 阅读 0 评论 0 点赞

所有类

概述

软件包

类

使用

树

已过时

索引

帮助

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

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 对象之外的任何其他内容