Cursor类在 Android中的使用

在Android SQLite数据库中，十分重要的概念。Cursor（游标）提供了一种对从表中检索出的数据进行操作的灵活手段，就本质而言，Cursor（游标）实际上是一种能从包括多条数据记录的结果集中每次提取一条记录的机制。今天特地将它单独拿出来谈，加深自己和大家对Android 中使用 Cursor 的理解。



1. 关于 Cursor



在你理解和使用 Android Cursor 的时候你必须先知道关于 Cursor 的几件事情：
Cursor 是每行的集合。
使用 moveToFirst() 定位第一行。
你必须知道每一列的名称。
你必须知道每一列的数据类型。
Cursor 是一个随机的数据源。
所有的数据都是通过下标取得。
Cursor 位于 android.database.Cursor类，可见出它的设计是基于数据库服务产生的。
在Android 查询数据是通过Cursor 类来实现的。当我们使用 SQLiteDatabase.query()方法时，就会得到Cursor对象， Cursor所指向的就是每一条数据。



2. 关于Cursor 的重要方法：



close()
关闭游标，释放资源
copyStringToBuffer(intcolumnIndex, CharArrayBuffer buffer)


在缓冲区中检索请求的列的文本，将将其存储
getColumnCount()


返回所有列的总数
getColumnIndex(StringcolumnName);


返回指定列的名称，如果不存在返回-1
getColumnIndexOrThrow(StringcolumnName);


从零开始返回指定列名称，如果不存在将抛出IllegalArgumentException 异常。
getColumnName(intcolumnIndex);


从给定的索引返回列名
getColumnNames();


返回一个字符串数组的列名
getCount();


返回Cursor 中的行数
moveToFirst();


移动光标到第一行
moveToLast();


移动光标到最后一行
moveToNext();


移动光标到下一行
moveToPosition(intposition);


移动光标到一个绝对的位置
moveToPrevious();



移动光标到上一行



3. 例子：



（1） 为空的Cursor的判断

if (cur.moveToFirst() == false){//为空的Cursorreturn;}

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

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

（3）循环 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);}

4:在Android 查询数据是通过Cursor 类来实现的。



当我们使用 SQLiteDatabase.query()方法时，就会得到Cursor对象， Cursor所指向的就是每一条数据。Cursor 位于 android.database.Cursor类，可见出它的设计是基于数据库服务产生的。