首页 > 代码库 > Cursor类

Cursor类

本文转自 http://blog.sina.com.cn/s/blog_618199e60101fskp.html,感谢作者

 

在你理解和使用 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){  
               return;
          }// 为空的Cursor

 

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

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


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

          while(cur.moveToNext()) {
              //光标移动成功

             String email = cursor.getString(cursor.getColumnIndex(RuiXin.EMAIL));

             startManagingCursor(cursor);  //查找后关闭游标 
             //把数据取出
          }


当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所指向的就是每一条数据。

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

 

另:Activity.startManagingCursor方法:

将获得的Cursor对象交与Activity管理,这样Cursor对象的生命周期便能与当前的Activity自动同步,省去了自己对Cursor的管理。

1.这个方法使用的前提是:游标结果集里有很多的数据记录。

所以,在使用之前,先对Cursor是否为null进行判断,如果Cursor != null,再使用此方法
2.如果使用这个方法,最后也要用stopManagingCursor()来把它停止掉,以免出现错误。
3.使用这个方法的目的是把获取的Cursor对象交给Activity管理,这样Cursor的生命周期便能和Activity自动同步,省去自己手动管理。

Cursor类