PDBStatement类

当前版本:v3.0, 更新时间:2020-09-16

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

实现的方法：

close 释放对象占用的资源。

execute 执行给定的SQL语句，在松果时序数据库中最多能返回一个结果。

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

executeUpdate 执行给定的SQL语句，可以是insert语句或不反回结果的语句。

getConnection 获取当前对象的Connection对象。

getResultSet 获取当前查询结果集。

getUpdateCount 返回更新计数的结果，如果结果为ResultSet或没有结果，则返回-1。

方法详细信息：

close

释放对象占用的资源。

void close() throws SQLException

抛出：

SQLException - 如果发生数据库访问错误

execute

执行给定的SQL语句，在松果时序数据库中最多能返回一个结果。

松果时序数据库只支持UTF8编码，驱动中已实现sql转UTF8。

boolean execute(String sql) throws SQLException

参数：

sql 要执行的SQL语句。

返回值：

如果执行结果为ResultSet对象，则返回true。

如果执行结果为更新计数或没有执行结果，则返回false。

抛出：

SQLException - 如果发生数据库访问错误，或者在已关闭的 Statement 上调用此方法，或者未能正确执行发送到数据库的命令之一。

executeQuery

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

PinusDB只支持UTF8编码，驱动中已实现sql转UTF8。

ResultSet executeQuery(String sql) throws SQLException

参数：

sql - 要发送给数据库的 SQL 查询语句。

返回：

包含给定查询所生成数据的 ResultSet 对象；

抛出：

SQLException - 如果发生数据库访问错误，在已关闭的 Statement 上调用此方法，或者给定 SQL 语句生成单个 ResultSet 对象之外的任何其他内容。

executeUpdate

执行给定 SQL 语句，该语句可能为 INSERT语句，或者不返回任何内容的 SQL 语句（如 SQL DDL 语句）。

int executeUpdate(String sql) throws SQLException

参数：

sql - SQL 数据操作语言（Data Manipulation Language，DML）语句，如 INSERT；或者不返回任何内容的 SQL 语句，如 DDL 语句。

返回：

(1) 对于 SQL 数据操作语言 (DML) 语句，返回行计数

(2) 对于什么都不返回的 SQL 语句，返回 0

抛出：

SQLException - 如果发生数据库访问错误，在已关闭的 Statement 上调用此方法，或者给定的 SQL 语句生成 ResultSet 对象

getConnection

获取生成此 Statement 对象的 Connection 对象。

Connection getConnection() throws SQLException

返回：

此语句生成的连接

抛出：

SQLException - 如果发生数据库访问错误，或者在已关闭的 Statement 上调用此方法

getResultSet

以 ResultSet 对象的形式获取当前结果。每个结果只应调用一次此方法。 

ResultSet getResultSet() throws SQLException

返回：

以 ResultSet 对象的形式返回当前结果；如果结果是更新计数或没有更多的结果，则返回 null

抛出：

SQLException - 如果发生数据库访问错误，或者在已关闭的 Statement 上调用此方法

getUpdateCount

以更新计数的形式获取当前结果；如果结果为 ResultSet 对象或没有更多结果，则返回 -1。每个结果只应调用一次此方法。

int getUpdateCount() throws SQLException

返回：

以更新计数的形式返回当前结果；如果当前结果为 ResultSet 对象或没有更多结果，则返回 -1

抛出：

SQLException - 如果发生数据库访问错误，或者在已关闭的 Statement 上调用此方法