Android 中关于【Cursor】类的介绍

绝地灬酷狼 2022-06-14 05:27 307阅读 0赞

## Android 中关于 【Cursor】 类的介绍 ##

使用过 SQLite 数据库的童鞋对 Cursor 应该不陌生，如果你是搞.net 开发你大可以把Cursor理解成 Ado.net 中的数据集合相当于dataReader。今天特地将它单独拿出来谈，加深自己和大家对Android 中使用 Cursor 的理解。

**关于 Cursor**

在你理解和使用 Android Cursor 的时候你必须先知道关于 Cursor 的几件事情：

*  Cursor 是每行的集合。
 *  使用 moveToFirst() 定位第一行。
 *  你必须知道每一列的名称。
 *  你必须知道每一列的数据类型。
 *  Cursor 是一个随机的数据源。
 *  所有的数据都是通过下标取得。

**关于 Cursor 的重要方法**：

*  [close][]()  
    关闭游标，释放资源
 *  [copyStringToBuffer][](int columnIndex, [CharArrayBuffer][] buffer)  
    在缓冲区中检索请求的列的文本，将将其存储
 *  [getColumnCount][]()  
    返回所有列的总数
 *  [getColumnIndex][]([String][] columnName)  
    返回指定列的名称，如果不存在返回-1
 *  [getColumnIndexOrThrow][]([String][] columnName)  
    从零开始返回指定列名称，如果不存在将抛出[IllegalArgumentException][] 异常。
 *  [getColumnName][](int columnIndex)  
    从给定的索引返回列名
 *  [getColumnNames][]()  
    返回一个字符串数组的列名
 *  [getCount][]()  
    返回Cursor 中的行数
 *  [moveToFirst][]()  
    移动光标到第一行
 *  [moveToLast][]()  
    移动光标到最后一行
 *  [moveToNext][]()  
    移动光标到下一行
 *  [moveToPosition][](int position)  
    移动光标到一个绝对的位置
 *  [moveToPrevious][]()  
    移动光标到上一行

下面来看看一小段代码：

if (cur.moveToFirst() == false )  
\{  
// 为空的Cursor

return ;  
\}

访问 Cursor 的下标获得其中的数据

int nameColumnIndex = cur.getColumnIndex(People.NAME);  
String name = cur.getString(nameColumnIndex);

现在让我们看看如何循环 Cursor 取出我们需要的数据

while (cur.moveToNext())  
\{  
// 光标移动成功  
// 把数据取出  
\}

当cur.moveToNext() 为假时将跳出循环，即 Cursor 数据循环完毕。

如果你喜欢用 for 循环而不想用While 循环可以使用Google 提供的几下方法：

*  [isBeforeFirst][]()  
    返回游标是否指向第一行之前的位置
 *  [isAfterLast][]()  
    返回游标是否指向最后一行之后的位置
 *  [isClosed][]()  
    如果返回 true 即表示该游戏标己关闭

有了以上的方法，可以如此取出数据

for (cur.moveToFirst(); ! cur.isAfterLast();cur.moveToNext())  
\{  
int nameColumn = cur.getColumnIndex(People.NAME);  
int phoneColumn = cur.getColumnIndex(People.NUMBER);  
String name = cur.getString(nameColumn);  
String phoneNumber = cur.getString(phoneColumn);  
\}

Tip:在Android 查询数据是通过Cursor 类来实现的。当我们使用 SQLiteDatabase.query()方法时，就会得到Cursor对象， Cursor所指向的就是每一条数据。结合ADO.net 的知识可能好理解一点。

Cursor 位于 android.database.Cursor类，可见出它的设计是基于数据库服务产生的。

另外，还有几个己知的子类，分别为：

*  [AbstractCursor][]
 *  [AbstractWindowedCursor][]
 *  [CrossProcessCursor][]
 *  [CursorWrapper][]
 *  [MatrixCursor][]
 *  [MergeCursor][]
 *  [MockCursor][]
 *  [SQLiteCursor][]

具体详细的使用方法和解释可以去参照API，这里就不过多讲述。

Cursor的使用和JDBC的ResultSet类似，Cursor初始化默认的指向位置为第一行的前一位。

所以我们在开始读取的时候就可以使用while(cursor.moveToNext())进行读取。

[转载地址][Link 1]

[close]: http://www.cnblogs.com/TerryBlog/admin/file:///D:/Program%20Files/android-sdk-windows/docs/reference/android/database/Cursor.html#close%28%29
[copyStringToBuffer]: http://www.cnblogs.com/TerryBlog/admin/file:///D:/Program%20Files/android-sdk-windows/docs/reference/android/database/Cursor.html#copyStringToBuffer%28int,%20android.database.CharArrayBuffer%29
[CharArrayBuffer]: http://www.cnblogs.com/TerryBlog/admin/file:///D:/Program%20Files/android-sdk-windows/docs/reference/android/database/CharArrayBuffer.html
[getColumnCount]: http://www.cnblogs.com/TerryBlog/admin/file:///D:/Program%20Files/android-sdk-windows/docs/reference/android/database/Cursor.html#getColumnCount%28%29
[getColumnIndex]: http://www.cnblogs.com/TerryBlog/admin/file:///D:/Program%20Files/android-sdk-windows/docs/reference/android/database/Cursor.html#getColumnIndex%28java.lang.String%29
[String]: http://www.cnblogs.com/TerryBlog/admin/file:///D:/Program%20Files/android-sdk-windows/docs/reference/java/lang/String.html
[getColumnIndexOrThrow]: http://www.cnblogs.com/TerryBlog/admin/file:///D:/Program%20Files/android-sdk-windows/docs/reference/android/database/Cursor.html#getColumnIndexOrThrow%28java.lang.String%29
[IllegalArgumentException]: http://www.cnblogs.com/TerryBlog/admin/file:///D:/Program%20Files/android-sdk-windows/docs/reference/java/lang/IllegalArgumentException.html
[getColumnName]: http://www.cnblogs.com/TerryBlog/admin/file:///D:/Program%20Files/android-sdk-windows/docs/reference/android/database/Cursor.html#getColumnName%28int%29
[getColumnNames]: http://www.cnblogs.com/TerryBlog/admin/file:///D:/Program%20Files/android-sdk-windows/docs/reference/android/database/Cursor.html#getColumnNames%28%29
[getCount]: http://www.cnblogs.com/TerryBlog/admin/file:///D:/Program%20Files/android-sdk-windows/docs/reference/android/database/Cursor.html#getCount%28%29
[moveToFirst]: http://www.cnblogs.com/TerryBlog/admin/file:///D:/Program%20Files/android-sdk-windows/docs/reference/android/database/Cursor.html#moveToFirst%28%29
[moveToLast]: http://www.cnblogs.com/TerryBlog/admin/file:///D:/Program%20Files/android-sdk-windows/docs/reference/android/database/Cursor.html#moveToLast%28%29
[moveToNext]: http://www.cnblogs.com/TerryBlog/admin/file:///D:/Program%20Files/android-sdk-windows/docs/reference/android/database/Cursor.html#moveToNext%28%29
[moveToPosition]: http://www.cnblogs.com/TerryBlog/admin/file:///D:/Program%20Files/android-sdk-windows/docs/reference/android/database/Cursor.html#moveToPosition%28int%29
[moveToPrevious]: http://www.cnblogs.com/TerryBlog/admin/file:///D:/Program%20Files/android-sdk-windows/docs/reference/android/database/Cursor.html#moveToPrevious%28%29
[isBeforeFirst]: http://www.cnblogs.com/TerryBlog/admin/file:///D:/Program%20Files/android-sdk-windows/docs/reference/android/database/Cursor.html#isBeforeFirst%28%29
[isAfterLast]: http://www.cnblogs.com/TerryBlog/admin/file:///D:/Program%20Files/android-sdk-windows/docs/reference/android/database/Cursor.html#isAfterLast%28%29
[isClosed]: http://www.cnblogs.com/TerryBlog/admin/file:///D:/Program%20Files/android-sdk-windows/docs/reference/android/database/Cursor.html#isClosed%28%29
[AbstractCursor]: http://www.cnblogs.com/TerryBlog/admin/file:///D:/Program%20Files/android-sdk-windows/docs/reference/android/database/AbstractCursor.html
[AbstractWindowedCursor]: http://www.cnblogs.com/TerryBlog/admin/file:///D:/Program%20Files/android-sdk-windows/docs/reference/android/database/AbstractWindowedCursor.html
[CrossProcessCursor]: http://www.cnblogs.com/TerryBlog/admin/file:///D:/Program%20Files/android-sdk-windows/docs/reference/android/database/CrossProcessCursor.html
[CursorWrapper]: http://www.cnblogs.com/TerryBlog/admin/file:///D:/Program%20Files/android-sdk-windows/docs/reference/android/database/CursorWrapper.html
[MatrixCursor]: http://www.cnblogs.com/TerryBlog/admin/file:///D:/Program%20Files/android-sdk-windows/docs/reference/android/database/MatrixCursor.html
[MergeCursor]: http://www.cnblogs.com/TerryBlog/admin/file:///D:/Program%20Files/android-sdk-windows/docs/reference/android/database/MergeCursor.html
[MockCursor]: http://www.cnblogs.com/TerryBlog/admin/file:///D:/Program%20Files/android-sdk-windows/docs/reference/android/test/mock/MockCursor.html
[SQLiteCursor]: http://www.cnblogs.com/TerryBlog/admin/file:///D:/Program%20Files/android-sdk-windows/docs/reference/android/database/sqlite/SQLiteCursor.html
[Link 1]: http://www.cnblogs.com/TerryBlog/archive/2010/07/05/1771459.html