Android Cursor 使用详解：为什么必须调用 moveToFirst()

        在 Android 开发中，使用 SQLite 数据库时，我们经常需要处理 Cursor 对象。一个常见的错误是直接尝试从 Cursor 中读取数据而没有先调用移动方法。本文将详细介绍为什么必须调用 moveToFirst() 或其他移动方法后才能读取数据。

1、Cursor 基本概念

        Cursor 是一个指向查询结果集的指针，它提供了遍历和访问数据库查询结果的方法。Cursor 的初始位置在结果集的第一个元素之前（位置 -1），因此在读取数据之前，必须先将光标移动到有效的位置。

2、为什么需要调用移动方法

        当执行数据库查询后，Cursor 被创建并指向结果集的起始位置之前（位置 -1）。此时如果直接调用 getString()、getInt() 等方法读取数据，会抛出异常。

        错误示例：

Cursor cursor = db.rawQuery("SELECT * FROM users", null);
String name = cursor.getString(0); // 会抛出异常，因为光标位置无效

        正确示例：

Cursor cursor = db.rawQuery("SELECT * FROM users", null);
if (cursor.moveToFirst()) {
    String name = cursor.getString(0); // 正确读取数据
}

3、常用的移动方法

        Cursor 提供了多种移动方法：

        moveToFirst()：移动到结果集的第一个位置

if (cursor.moveToFirst()) {
    // 读取数据
}

        moveToLast()：移动到结果集的最后一个位置

if (cursor.moveToLast()) {
    // 读取数据
}

        moveToNext()：移动到下一个位置

while (cursor.moveToNext()) {
    // 读取数据
}

        moveToPrevious()：移动到前一个位置

if (cursor.moveToPrevious()) {
    // 读取数据
}

        moveToPosition(int position)：移动到指定位置

if (cursor.moveToPosition(2)) {
    // 读取数据
}

4、总结

        在使用 Android Cursor 时，必须记住以下要点：

        - Cursor 的初始位置在结果集的第一个元素之前（位置 -1）

        - 在读取数据之前，必须调用移动方法（如 moveToFirst()、moveToNext() 等）

        - 使用 getColumnIndex() 获取列索引，避免硬编码

        - 使用 try-finally 块确保 Cursor 被正确关闭

        - 检查移动方法的返回值，确认移动是否成功

        通过遵循这些最佳实践，可以避免常见的 Cursor 操作错误，编写出更加健壮的数据库代码。