PDBStatement类
用于执行静态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 上调用此方法