行数据检索

通过执行以下常规任务来检索表中的行数据：

在字符串变量中构造一个 SELECT SQL 语句。
通过将字符串变量传递给 Connection.prepareStatement 方法，创建一个 PreparedStatement 对象。
调用 PreparedStatement.executeQuery 方法以将查询结果指派给 ResultSet 对象。
使用导航方法遍历 ResultSet 对象，以检索行数据。

可使用以下导航方法来遍历结果集：
- afterLast¹ 紧跟最后一行之后定位。
- beforeFirst¹ 紧跟第一行之前定位。
- first¹ 移至第一行。
- last¹ 移至最后一行。
- next 移至下一行。
- previous 移至上一行。
- relative(offset)¹ 根据指定的标记偏移值，相对于当前行移动一定的行数。如果偏移值为正，则相对于结果集中的当前指针位置在结果集中向前移动。如果偏移值为负，则在结果集中向后移动。如果偏移值为零，则不移动当前位置，但可以重新填充行缓冲区。
¹ UltraLite Java 版数据库不支持此方法。
关闭 ResultSet 和 PreparedStatement 对象以释放资源。

示例

本示例中所引用的代码属于一个完整示例的一部分，该完整示例说明了如何使用 UltraLiteJ API 来执行基本的模式和数据管理操作。请参见示例：在 Android 智能手机上管理数据库操作。

在自定义 SelectDepartmentRows 方法中检索到一个结果集：

public ResultSet SelectDepartmentRows() {
    String stmt = "SELECT * FROM Department ORDER BY dept_no";
    _preparer = null;
    _departments = null;
    try {
        _preparer = _conn.prepareStatement(stmt);
        _departments = _preparer.executeQuery();
        PrintText("Successfully executed: " + stmt);
    } catch (ULjException e) {
        HandleError(e);
    }
    return _departments;
}

使用 next 导航方法遍历结果集，检索得到行数据：

_departments = SelectDepartmentRows();
if (_departments != null) {
    try {
        while(_departments.next()) {
            int dept_no = _departments.getInt(1);
            String dept_name = _departments.getString(2);
            PrintText("Department no.:" + dept_no
                    + " Department name: " + dept_name);
        }
    } catch (ULjException e) {
        HandleError(e);
    }
}

另请参见

使用DocCommentXchange讨论此页。