PDBResultSet类

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

表示数据库结果集的数据表，通过执行查询数据库的语句生成。

实现的方法

absolute 将指针移动到此 ResultSet 对象的给定行编号。

afterLast 将指针移动到此 ResultSet 对象的末尾，正好位于最后一行之后。

beforeFirst 将指针移动到此 ResultSet 对象的开头，正好位于第一行之前。

close 释放此 ResultSet 对象的数据库和 JDBC 资源

findColumn 将给定的 ResultSet 列标签映射到其 ResultSet 列索引。

first 将指针移动到此 ResultSet 对象的第一行。

getBoolean 获取 boolean 值。

getBytes 获取byte[]值，对应表中blob列。

getFloat 获取float值，对应表中float列。

getDouble 获取double值，对应表中double列。

getByte 获取byte值，对应表中的tinyint列。

getShort 获取short值，对应表中的smallint列。

getInt 获取int值，对应表中的int列

getLong 获取long值，对应表中的bigint列。

getMetaData 获取此 ResultSet 对象的列的名称、类型和属性。

getObject 以 Object 的形式获取值。若结果为String类型，则以UTF8编码。

getRow 获取当前行编号。

getString 获取String值。获取结果为UTF8编码。

getTimestamp 获取Timestamp值。对应Datetime列。

isAfterLast 获取指针是否位于此 ResultSet 对象的最后一行之后。

isBeforeFirst 获取指针是否位于此 ResultSet 对象的第一行之前。

isFirst 获取指针是否位于此 ResultSet 对象的第一行。

isLast 获取指针是否位于此 ResultSet 对象的最后一行。

last 将指针移动到此 ResultSet 对象的最后一行。

next 将指针从当前位置向前移一行。

previous 将指针移动到此 ResultSet 对象的上一行。

relative 按相对行数（或正或负）移动指针。

wasNull 报告最后一个读取的列是否是 SQL NULL。

方法详细信息

absolute

  1. boolean absolute(int row) throws SQLException

将光标移动到PDBResult 结果集给定的行编号。

如果行编号为正，则将光标移动到相对于结果集开头的给定行编号。第一行为行 1，第二行为行 2，依此类推。

如果给定行编号为负，则将光标移动到相对于结果集末尾的绝对行位置。例如，调用方法 absolute(-1) 将光标置于最后一行；调用方法 absolute(-2) 将光标移动到倒数第二行，依此类推。

试图将光标置于结果集的第一行/最后一行之外将导致光标位于第一行之前或最后一行之后。

注：调用 absolute(1) 等效于调用 first()。调用 absolute(-1) 等效于调用 last()。

参数：

row - 光标应该移动到的行的编号。正的编号指示从结果集开头开始计数的行编号；负的编号指示从结果集末尾开始计数的行编号

返回：

如果光标移动到此 PDBResult对象的位置处，则返回 true；如果光标在第一行的前面或最后一行的后面，则返回 false

抛出：

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

afterLast

  1. void afterLast()throws SQLException

将光标移动到此 PinusDBResult对象的末尾，正好位于最后一行之后。如果结果集中不包含任何行，则此方法无效。

抛出：

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

beforeFirst

  1. void beforeFirst() throws SQLException

将光标移动到此 PinusDBResult对象的开头，正好位于第一行之前。如果结果集中不包含任何行，则此方法无效。

抛出：

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

close

  1. void close() throws SQLException

立即释放此 PinusDBResult对象的数据库资源

抛出：

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

findColumn

  1. int findColumn(String columnLabel)throws SQLException

将给定的 PDBResult列标签映射到其 PDBResult列索引。

参数：

columnLabel - 列名称

返回：

给定列名称的列索引

抛出：

SQLException - 如果 PDBResult对象不包含标记为 columnLabel 的列，或发生数据库访问错误或在已关闭的结果集上调用此方法。

first

  1. boolean first()throws SQLException

将光标移动到此 PDBResult对象的第一行。

返回：

如果光标位于有效行，则返回 true；如果结果集中不存在任何行，则返回 false

抛出：

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

getBoolean

  1. byte getBoolean(int columnIndex)throws SQLException

以 Java 编程语言中 boolean的形式获取此 PDBResult对象的当前行中指定列的值。

参数：

columnIndex - 第一个列是 1，第二个列是 2，……

返回：

列值；如果值为 SQL NULL，则返回值为 false

抛出：

SQLException - 如果 columnIndex 无效；或者实际类型不匹配。

getLong

  1. long getLong(int columnIndex)throws SQLException

以 Java 编程语言中 long 的形式获取此 PDBResult对象的当前行中指定列的值。

参数：

columnIndex - 第一个列是 1，第二个列是 2，……

返回：

列值；如果值为 SQL NULL，则返回值为 0

抛出：

SQLException - 如果 columnIndex 无效；或者实际类型不匹配。

getLong

  1. long getLong(String columnLabel)throws SQLException

以 Java 编程语言中 long 的形式获取此 PDBResult对象的当前行中指定列的值。

参数：

columnLabel - 列名称

返回：

列值；如果值为 SQL NULL，则返回值为 0

抛出：

SQLException - 如果 columnLabel 无效；或者实际类型不匹配。

getDouble

  1. double getDouble(int columnIndex)throws SQLException

以 Java 编程语言中 double 的形式获取此 PDBResult对象的当前行中指定列的值。

参数：

columnIndex - 第一个列是 1，第二个列是 2，……

返回：

列值；如果值为 SQL NULL，则返回值为 0

抛出：

SQLException - 如果 columnIndex 无效；或者实际类型不匹配。

getDouble

  1. double getDouble(String columnLabel) throws SQLException

以 Java 编程语言中 double 的形式获取此 PDBResult对象的当前行中指定列的值。

参数：

columnLabel - 列名称

返回：

列值；如果值为 SQL NULL，则返回值为 0

抛出：

SQLException - 如果 columnLabel 无效；或者实际类型不匹配。

getString

  1. String getString(int columnIndex)throws SQLException

以 Java 编程语言中 String 的形式获取此 PDBResult对象的当前行中指定列的值。

参数：

columnIndex - 第一个列是 1，第二个列是 2，……

返回：

列值；如果值为 SQL NULL，则返回值为 null

抛出：

SQLException - 如果 columnIndex 无效；或者实际类型不匹配。

getString

  1. String getString(String columnLabel)throws SQLException

以 Java 编程语言中 String 的形式获取此 PDBResult对象的当前行中指定列的值。

参数：

columnLabel - 列名称

返回：

列值；如果值为 SQL NULL，则返回值为 null

抛出：

SQLException - 如果 columnLabel 无效；或者实际类型不匹配。

getBytes

  1. byte[] getBytes(int columnIndex)throws SQLException

以 Java 编程语言中 byte 数组的形式获取此 PDBResult对象的当前行中指定列的值。

参数：

columnIndex - 第一个列是 1，第二个列是 2，……

返回：

列值； 如果值为 SQL NULL，则返回值为 null

抛出：

SQLException - 如果 columnIndex 无效；或者实际类型不匹配。

getBytes

  1. byte[] getBytes(String columnLabel)throws SQLException

以 Java 编程语言中 byte 数组的形式获取此 PinusDBResult对象的当前行中指定列的值。

参数：

columnLabel -列名称

返回：

列值；如果值为 SQL NULL，则返回值为 null

抛出：

SQLException - 如果 columnLabel 无效；或者实际类型不匹配。

getObject

  1. Object getObject(int columnIndex)throws SQLException

以 Java 编程语言中 Object 的形式获取此 PinusDBResult对象的当前行中指定列的值。

参数：

columnIndex - 第一个列是 1，第二个列是 2，……

返回：

保存列值的 java.lang.Object

抛出：

SQLException - 如果 columnIndex 无效；或者实际类型不匹配。

getObject

  1. Object getObject(String columnLabel)throws SQLException

以 Java 编程语言中 Object 的形式获取此 PDBResult对象的当前行中指定列的值。

参数：

columnLabel - 列名称

返回：

保存列值的 java.lang.Object

抛出：

SQLException - 如果 columnLabel 无效；或者实际类型不匹配。

isAfterLast

  1. boolean isAfterLast()throws SQLException

获取光标是否位于此 PinusDBResult对象的最后一行之后。

返回：

如果光标位于最后一行之后，则返回 true；如果光标位于任何其他位置或者结果集不包含任何行，则返回 false

抛出：

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

isBeforeFirst

  1. boolean isBeforeFirst()throws SQLException

获取光标是否位于此 PinusDBResult对象的第一行之前。

返回：

如果光标位于第一行之前，则返回 true；如果光标位于任何其他位置或者结果集不包含任何行，则返回 false

抛出：

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

isFirst

  1. boolean isFirst() throws SQLException

获取光标是否位于此 PinusDBResult对象的第一行。

返回：

如果光标位于第一行，则返回 true；否则返回 false

抛出：

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

isLast

  1. boolean isLast()throws SQLException

获取光标是否位于此 PinusDBResult对象的最后一行。

返回：

如果光标位于最后一行上，则返回 true；否则返回 false

抛出：

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

last

  1. boolean last()throws SQLException

将光标移动到此 PinusDBResult对象的最后一行。

返回：

如果光标位于有效行，则返回 true；如果结果集中不存在任何行，则返回 false

抛出：

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

next

  1. boolean next()throws SQLException

将光标从当前位置向前移一行。PinusDBResult光标最初位于第一行之前；第一次调用 next 方法使第一行成为当前行；第二次调用使第二行成为当前行，依此类推。

返回：

如果新的当前行有效，则返回 true；如果不存在下一行，则返回 false

抛出：

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

previous

  1. boolean previous()throws SQLException

将光标移动到此 PinusDBResult对象的上一行。

当调用 previous 方法返回 false 时，光标位于第一行之前。

返回：

如果光标现在位于有效行上，则返回 true；如果光标位于第一行的前面，则返回 false

抛出：

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

relative

  1. boolean relative(int rows)throws SQLException

按相对行数（或正或负）移动光标。试图移动到结果集的第一行/最后一行之外，会将光标置于第一行之前或最后一行之后。调用 relative(0) 有效，但是不更改光标位置。

注：调用方法 relative(1) 等效于调用方法 next()，而调用方法 relative(-1) 等效于调用方法 previous()。

参数：

rows - 指定从当前行开始移动的行数的 int；正数表示光标向前移动；负数表示光标向后移动

返回：

如果光标位于行上，则返回 true；否则返回 false

抛出：

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

getRow

  1. int getRow()throws SQLException

获取当前行编号。第一行为 1 号，第二行为 2 号，依此类推。

返回：

当前行的编号；如果不存在当前行，则返回 0

抛出：

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

wasNull

  1. boolean wasNull()throws SQLException

报告最后一个读取的列是否具有值 SQL NULL。注意，必须首先对列调用一个获取方法尝试读取其值，然后调用 wasNull 方法查看读取的值是否为 SQL NULL。

返回：

如果最后一个读取的列值为 SQL NULL，则返回 true；否则返回 false

抛出：

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