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 上调用此方法