Statement

CLOSE_ALL_RESULTS

int CLOSE_ALL_RESULTS

该常数指示在调用 getMoreResults时应关闭先前保持打开的所有 ResultSet对象。

常量值：3（0x00000003）

CLOSE_CURRENT_RESULT

int CLOSE_CURRENT_RESULT

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

常数值：1（0x00000001）

EXECUTE_FAILED

int EXECUTE_FAILED

该常数表示在执行批处理语句时发生错误。

常量值：-3（0xfffffffd）

KEEP_CURRENT_RESULT

int KEEP_CURRENT_RESULT

当调用 getMoreResults时，表示当前 ResultSet对象不应该关闭的 getMoreResults 。

常量值：2（0x00000002）

NO_GENERATED_KEYS

int NO_GENERATED_KEYS

表示生成的密钥不应用于检索的常量。

常量值：2（0x00000002）

RETURN_GENERATED_KEYS

int RETURN_GENERATED_KEYS

表示生成的密钥应该可用于检索的常量。

常数值：1（0x00000001）

SUCCESS_NO_INFO

int SUCCESS_NO_INFO

该常量表示批处理语句已成功执行，但不影响其受影响的行数。

常量值：-2（0xfffffffe）

addBatch

void addBatch (String sql)

将给定的SQL命令添加到此Statement对象的当前命令列表中。 该列表中的命令可以通过调用方法executeBatch以批处理方式executeBatch 。

注意：此方法无法在 PreparedStatement或 CallableStatement 。

cancel

void cancel ()

如果DBMS和驱动程序都支持中止SQL语句，则取消此Statement对象。 这个方法可以被一个线程用来取消另一个线程正在执行的语句。

clearBatch

void clearBatch ()

清空这个 Statement对象的当前SQL命令列表。

clearWarnings

void clearWarnings ()

清除此Statement对象上报告的所有警告。 在调用此方法后，方法getWarnings将返回null直到报告此Statement对象的新警告。

close

void close ()

立即释放此Statement对象的数据库和JDBC资源，而不是等待它自动关闭时发生。 一旦您完成了资源释放资源以避免捆绑数据库资源，通常是一种很好的做法。

调用已关闭的 Statement对象上的方法 close不起作用。

注：关闭 Statement对象时，其当前 ResultSet对象（如果存在）也会关闭。

execute

boolean execute (String sql, 
                int autoGeneratedKeys)

执行给定的SQL语句，该语句可能会返回多个结果，并向驱动程序发出通知，指出应该使任何自动生成的密钥可用于检索。 如果SQL语句不是INSERT语句，或者SQL语句能够返回自动生成的键（这些语句的列表是特定于供应商的），驱动程序将忽略此信号。

在某些（不常见）情况下，单个SQL语句可能会返回多个结果集和/或更新计数。 通常情况下，你可以忽略它，除非你（1）执行一个你知道可能返回多个结果的存储过程，或者（2）你动态地执行一个未知的SQL字符串。

execute方法执行一条SQL语句并指示第一个结果的形式。 然后您必须使用方法getResultSet或getUpdateCount检索结果，并使用getMoreResults移至任何后续结果。

注意：此方法无法在 PreparedStatement或 CallableStatement 。

execute

boolean execute (String sql)

执行给定的SQL语句，该语句可能会返回多个结果。 在某些（不常见）情况下，单个SQL语句可能会返回多个结果集和/或更新计数。 通常情况下，你可以忽略它，除非你（1）执行一个你知道可能返回多个结果的存储过程，或者（2）你动态地执行一个未知的SQL字符串。

execute方法执行SQL语句并指示第一个结果的形式。 您必须使用方法getResultSet或getUpdateCount检索结果，并使用getMoreResults移至任何后续结果。

注意：此方法无法在 PreparedStatement或 CallableStatement 。

execute

boolean execute (String sql, 
                int[] columnIndexes)

执行给定的SQL语句，该语句可能会返回多个结果，并向驱动程序发出指示给定数组中指示的自动生成的键应该可用于检索的信号。 此数组包含目标表中包含应该使其可用的自动生成的键的列索引。 如果SQL语句不是INSERT语句，或者SQL语句能够返回自动生成的键（这些语句的列表是特定于供应商的），驱动程序将忽略该数组。

在某些（不常见）情况下，单个SQL语句可能会返回多个结果集和/或更新计数。 通常情况下，你可以忽略它，除非你（1）执行一个你知道可能返回多个结果的存储过程，或者（2）你动态地执行一个未知的SQL字符串。

execute方法执行一条SQL语句并指示第一个结果的形式。 然后您必须使用方法getResultSet或getUpdateCount检索结果，并使用getMoreResults移至任何后续结果。

注意：此方法无法在 PreparedStatement或 CallableStatement 。

execute

boolean execute (String sql, 
                String[] columnNames)

执行给定的SQL语句，该语句可能会返回多个结果，并向驱动程序发出指示给定数组中指示的自动生成的键应该可用于检索的信号。 此数组包含目标表中包含应该使其可用的自动生成的键的列的名称。 如果SQL语句不是INSERT语句，或者SQL语句能够返回自动生成的键（这些语句的列表是特定于供应商的），驱动程序将忽略数组。

在某些（不常见）情况下，单个SQL语句可能会返回多个结果集和/或更新计数。 通常情况下，你可以忽略它，除非你（1）执行一个你知道可能返回多个结果的存储过程，或者（2）你动态地执行一个未知的SQL字符串。

execute方法执行一条SQL语句并指示第一个结果的形式。 然后您必须使用方法getResultSet或getUpdateCount检索结果，并使用getMoreResults移至任何后续结果。

注意：此方法无法在 PreparedStatement或 CallableStatement 。

executeBatch

int[] executeBatch ()

向数据库提交一批命令以执行，如果所有命令都成功执行，则返回一组更新计数。 返回数组的int元素的顺序与批次中的命令相对应，这些命令按照它们添加到批次中的顺序排序。 由方法executeBatch返回的数组中的元素可能是以下之一：

1. A number greater than or equal to zero -- indicates that the command was processed successfully and is an update count giving the number of rows in the database that were affected by the command's execution
2. A value of SUCCESS_NO_INFO -- indicates that the command was processed successfully but that the number of rows affected is unknown

   如果批量更新中的某个命令无法正确执行，则此方法将引发BatchUpdateException ，并且JDBC驱动程序可能会或可能不会继续处理批处理中的其余命令。 但是，驱动程序的行为必须与特定的DBMS保持一致，要么始终继续处理命令，要么永远不会继续处理命令。 如果驱动程序在失败后继续处理，则方法BatchUpdateException.getUpdateCounts返回的数组将包含与批处理中的命令一样多的元素，并且至少有一个元素为以下内容：

3. A value of EXECUTE_FAILED -- indicates that the command failed to execute successfully and occurs only if a driver continues to process commands after a command fails

在Java 2 SDK Standard Edition 1.3版中修改了可能的实现和返回值，以适应在抛出 BatchUpdateException对象后继续处理批量更新中的命令的选项。

executeQuery

ResultSet executeQuery (String sql)

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

注意：此方法无法在 PreparedStatement或 CallableStatement 。

executeUpdate

int executeUpdate (String sql)

执行给定的SQL语句，这可能是 INSERT ， UPDATE ，或 DELETE声明，或者不返回任何内容，如SQL DDL语句的SQL语句。

注意：此方法无法在 PreparedStatement或 CallableStatement 。

executeUpdate

int executeUpdate (String sql, 
                String[] columnNames)

执行给定的SQL语句并向驱动程序发出指示给定数组中指示的自动生成的键应该可用于检索的信号。 此数组包含目标表中包含应该使其可用的自动生成的键的列的名称。 如果SQL语句不是INSERT语句，或者SQL语句能够返回自动生成的键（这些语句的列表是特定于供应商的），驱动程序将忽略该数组。

注意：不能在 PreparedStatement或 CallableStatement上调用此方法。

executeUpdate

int executeUpdate (String sql, 
                int[] columnIndexes)

执行给定的SQL语句并向驱动程序发出指示给定数组中指示的自动生成的键应该可用于检索的信号。 此数组包含目标表中包含应该使其可用的自动生成的键的列索引。 如果SQL语句不是INSERT语句，或者SQL语句能够返回自动生成的键（这些语句的列表是特定于供应商的），驱动程序将忽略该数组。

注意：此方法无法在 PreparedStatement或 CallableStatement 。

executeUpdate

int executeUpdate (String sql, 
                int autoGeneratedKeys)

执行给定的SQL语句并用给定的标志向驱动程序发出有关是否应该使该Statement对象产生的自动生成的密钥可用于检索的信号。 如果SQL语句不是INSERT语句，或者SQL语句能够返回自动生成的键（这些语句的列表是特定于供应商的），驱动程序将忽略此标志。

注意：此方法无法在 PreparedStatement或 CallableStatement 。

getConnection

Connection getConnection ()

检索 Connection生成此对象 Statement对象。

getFetchDirection

int getFetchDirection ()

检索从数据库表中提取行的方向，这是从此Statement对象生成的结果集的默认值。 如果此Statement对象没有通过调用方法setFetchDirection设置获取方向，则返回值是特定于实现的。

getFetchSize

int getFetchSize ()

检索结果集合的行数是默认为获取大小ResultSet从该生成的对象Statement对象。 如果此Statement对象没有通过调用方法setFetchSize设置获取大小，则返回值是特定于实现的。

getGeneratedKeys

ResultSet getGeneratedKeys ()

检索由于执行此Statement对象而创建的所有自动生成的密钥。 如果这个Statement对象没有生成任何键，则返回一个空的ResultSet对象。

注意：如果未指定代表自动生成密钥的列，则JDBC驱动程序实现将确定最能代表自动生成密钥的列。

getMaxFieldSize

int getMaxFieldSize ()

检索由此ResultSet对象生成的Statement对象中可以返回字符和二进制列值的最大字节数。 此限制仅适用于BINARY ， VARBINARY ， LONGVARBINARY ， CHAR ， VARCHAR ， NCHAR ， NVARCHAR ， LONGNVARCHAR个LONGVARCHAR列。 如果超出限制，则会过多丢弃超量数据。

getMaxRows

int getMaxRows ()

检索ResultSet对象生成的Statement对象可以包含的最大行数。 如果超出此限制，多余的行将被无声地丢弃。

getMoreResults

boolean getMoreResults (int current)

移动到此 Statement对象的下一个结果，与任何电流 ResultSet根据由给定的标志指定的指令对象（一个或多个），并且返回 true如果下一个结果是 ResultSet对象。

当以下情况属实时，没有更多结果：

     // stmt is a Statement object
     ((stmt.getMoreResults(current) == false) && (stmt.getUpdateCount() == -1))
 

getMoreResults

boolean getMoreResults ()

移动到 Statement对象的下一个结果，如果它是 ResultSet对象，则返回 true ，并隐式关闭使用方法 getResultSet获取的所有当前 ResultSet对象。

当以下情况属实时，没有更多结果：

     // stmt is a Statement object
     ((stmt.getMoreResults() == false) && (stmt.getUpdateCount() == -1))
 

getQueryTimeout

int getQueryTimeout ()

检索驱动程序将等待Statement对象执行的Statement 。 如果超出限制，则引发SQLException 。

getResultSet

ResultSet getResultSet ()

以ResultSet对象的形式检索当前结果。 每个结果只能调用一次该方法。

getResultSetConcurrency

int getResultSetConcurrency ()

检索由此 ResultSet对象生成的 Statement对象的结果集并发性。

getResultSetHoldability

int getResultSetHoldability ()

检索由此 ResultSet对象生成的 Statement对象的结果集可保存性。

getResultSetType

int getResultSetType ()

检索由此 ResultSet对象生成的 Statement对象的结果集类型。

getUpdateCount

int getUpdateCount ()

以更新计数检索当前结果; 如果结果是ResultSet对象或没有更多结果，则返回-1。 每个结果只能调用一次该方法。

getWarnings

SQLWarning getWarnings ()

检索此Statement对象通过调用报告的第一个警告。 随后的Statement对象警告将被链接到此SQLWarning对象。

每次语句被重新执行时，警告链都会自动清除。 此方法不能在封闭的Statement对象上调用; 这样做会导致SQLException被抛出。

注意：如果您正在处理 ResultSet对象，则与该 ResultSet对象上的读取相关的任何警告都将链接在该对象上，而不是链接在产生该对象的 Statement对象上。

isClosed

boolean isClosed ()

检索此Statement对象是否已关闭。 如果方法关闭已被调用，或者自动关闭，则关闭Statement 。

isPoolable

boolean isPoolable ()

返回一个值，指示 Statement是否可以 Statement 。

setCursorName

void setCursorName (String name)

将SQL游标名称设置为给定的String ，随后的Statement对象execute方法将使用该名称。 然后可以在SQL定位的更新或删除语句中使用此名称来标识由此语句生成的ResultSet对象中的当前行。 如果数据库不支持定位更新/删除，则此方法为noop。 为确保游标具有适当的隔离级别以支持更新，游标的SELECT语句应具有格式SELECT FOR UPDATE 。 如果FOR UPDATE不存在，定位更新可能会失败。

注意：根据定义，定位更新和删除的执行必须由与生成用于定位的ResultSet对象不同的Statement对象完成。 而且，游标名称在连接中必须是唯一的。

setEscapeProcessing

void setEscapeProcessing (boolean enable)

设置退出处理的开启或关闭。 如果转义扫描处于打开状态（默认状态），驱动程序会在将SQL语句发送到数据库之前执行转义替换。 注意：由于准备好的语句在进行此调用之前通常会被解析，因此禁用PreparedStatements对象的转义处理将不起作用。

setFetchDirection

void setFetchDirection (int direction)

为驱动程序提供有关使用此Statement对象创建的对象在ResultSet对象中的处理方向的提示。 默认值是ResultSet.FETCH_FORWARD 。

请注意，此方法设置由此Statement对象生成的结果集的默认获取方向。 每个结果集都有自己的获取和设置自己获取方向的方法。

setFetchSize

void setFetchSize (int rows)

当此Statement ResultSet对象需要更多行时，向JDBC驱动程序提示应该从数据库中提取的行Statement 。 如果指定的值为零，则提示将被忽略。 默认值为零。

setMaxFieldSize

void setMaxFieldSize (int max)

设置此ResultSet对象生成的Statement对象中可以返回字符和二进制列值的最大字节数限制。 此限制仅适用于BINARY ， VARBINARY ， LONGVARBINARY ， CHAR ， VARCHAR ， NCHAR ， NVARCHAR ， LONGNVARCHAR个LONGVARCHAR领域。 如果超出限制，则会过多丢弃超量数据。 为了获得最大的便携性，请使用大于256的值。

setMaxRows

void setMaxRows (int max)

设置由此ResultSet对象生成的任何Statement对象可包含的给定数量的最大行数限制。 如果超出限制，超出的行将被无声地丢弃。

setPoolable

void setPoolable (boolean poolable)

要求将Statement合并或不合并。 指定的值是语句池实现的一个提示，指示应用程序是否希望语句被合并。 由声明池管理员决定是否使用提示。

一个语句的极大值适用于驱动程序实现的内部语句高速缓存和应用程序服务器和其他应用程序实现的外部语句高速缓存。

默认情况下， Statement在创建时 CallableStatement被 PreparedStatement ， CallableStatement和 CallableStatement创建时可以 CallableStatement 。

setQueryTimeout

void setQueryTimeout (int seconds)

将驱动程序等待Statement对象执行的秒数设置为给定秒数。 默认情况下，对于运行语句完成所允许的时间量没有限制。 如果超出限制，则抛出SQLTimeoutException 。 JDBC驱动程序必须将此限制到execute ， executeQuery和executeUpdate方法。

注意： JDBC驱动程序实现也可能将此限制应用于 ResultSet方法（有关详细信息，请参阅您的驱动程序供应商文档）。

注意：对于 Statement批处理，它的实现定义为超时是应用于通过 addBatch方法添加的单个SQL命令还是应用于由 executeBatch方法调用的整批SQL命令（请参阅驱动程序供应商文档了解详情）。