SQLite中Cursor类的说明

在Android 查询数据是通过Cursor 类来实现的。当我们使用 SQLiteDatabase.query()方法时，就会得到Cursor对象， Cursor所指向的就是每一条数据。

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

子类有：

• AbstractCursor
• AbstractWindowedCursor
•  CrossProcessCursor
•  CursorWrapper
•  MatrixCursor
•  MergeCursor
•  MockCursor
• SQLiteCursor

1.Cursor必知

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

2.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() 
  移动光标到上一行

3.如何使用

（1）判断cursor是否为空

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

（2）获取列值

*获取单个的列值
//获取列名为name的列索引
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 数据循环完毕

3.补充

Activity.startManagingCursor方法：

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

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

所以，在使用之前，先对Cursor是否为null进行判断，如果Cursor != null，再使用此方法

2.如果使用这个方法，最后也要用stopManagingCursor（）来把它停止掉，以免出现错误。

3.使用这个方法的目的是把获取的Cursor对象交给Activity管理，这样Cursor的生命周期便能和Activity自动同步，省去自己手动管理。

（绑定到ListView的Cursor必须有_id项，否则会有异常抛出）

例：

public void queryTheCursor(View view) {
02
    Cursor c = mgr.queryTheCursor();
03
    startManagingCursor(c); //托付给activity根据自己的生命周期去管理Cursor的生命周期
04
    CursorWrapper cursorWrapper = new CursorWrapper(c) {
05
        @Override
06
        public String getString(int columnIndex) {
07
            //将简介前加上年龄
08
            if (getColumnName(columnIndex).equals("info")) {
09
                int age = getInt(getColumnIndex("age"));
10
                return age + " years old, " + super.getString(columnIndex);
11
            }
12
            return super.getString(columnIndex);
13
        }
14
    };
15
    //确保查询结果中有"_id"列
16
    SimpleCursorAdapter adapter = new SimpleCursorAdapter(this, android.R.layout.simple_list_item_2,
17
            cursorWrapper, new String[]{"name", "info"}, new int[]{android.R.id.text1, android.R.id.text2});
18
    ListView listView = (ListView) findViewById(R.id.listView_db);
19
    listView.setAdapter(adapter);
20
}

4.补充2  SimpleCursorAdapter

（转http://www.nowamagic.net/academy/detail/50350111）

一般在做网页的时候，要显示一个列表的数据，一般是对一个list的类进行循环，输出一大串的HTML字符串。数据比较多的话就会分页，比如一页10条记录，去数据库查询的时候就会limit 10条记录，速度非常快。

但在 Android中遇到几千条数据的时候，上下滑动，跟几十条数据的滑动流畅程度差不多，就是刚开始载入速度不一样。对Android 中的Adapter 数据绑定，进行Log输出后，发现是边滑动，数据边绑定的，并不是有多少数据一次性绑定完。但是数据一般是用sql 语句一次性查询出来，这点跟Web中的还是有点区别。

Android中ListView一般跟Cursor和Adapter有关。很多东西google都帮你弄好了，你只需要按照它约定的弄就行了。“你动不了Application Framework 的大结构，也不需要动。这是福利不是约束”。

SimpleCursorAdapter 的函数定义是：

SimpleCursorAdapter(Context context, int layout, Cursor c, String[] from, int[] to)

第二个layout的参数是ListView中单行的布局, c是你数据的游标。刚开始其实from和to比较让人不熟悉，From是你查询出的数据，to是单行布局中的单独控件，一对一的关系，用起来非常方便。比如：

SimpleCursorAdapter adapter = new SimpleCursorAdapter(this,
    R.layout.provice_list_item, cursor,
    new String[] {Location.PROVICE, Location.CITY },
    new int[] { R.id.princeTextView,android.R.id.text1 });

写好Adapter，基本上大部分工作已经完成，只需要给你的listview设置这个adapter就行了。一个显示数据的列表就完成了。

需要注意的是SimpleCursorAdapter的应用，当我们使用这个适配器时，我们必须先得到一个Cursor对象，这里面有几个问题：如何管理Cursor的生命周期，如果包装Cursor，Cursor结果集都需要注意什么。

如果手动去管理Cursor的话会非常的麻烦，还有一定的风险，处理不当的话运行期间就会出现异常，幸好Activity为我们提供了startManagingCursor(Cursor cursor)方法，它会根据Activity的生命周期去管理当前的Cursor对象。

startManagingCursor

下面是 startManagingCursor 方法的说明：

文中提到，startManagingCursor方法会根据Activity的生命周期去管理当前的Cursor对象的生命周期，就是说（1）当Activity停止时他会自动调用Cursor的deactivate方法，禁用游标，（2）当Activity重新回到屏幕时它会调用Cursor的requery方法再次查询，（3）当Activity摧毁时，被管理的Cursor都会自动关闭释放。

如何包装Cursor？我们会使用到CursorWrapper对象去包装我们的Cursor对象，实现我们需要的数据转换工作，这个CursorWrapper实际上是实现了Cursor接口。我们查询获取到的Cursor其实是Cursor的引用，而系统实际返回给我们的必然是Cursor接口的一个实现类的对象实例，我们用CursorWrapper包装这个实例，然后再使用SimpleCursorAdapter将结果显示到列表上。

Cursor结果集需要注意些什么：一个最需要注意的是，在我们的结果集中必须要包含一个“_id”的列，否则SimpleCursorAdapter就会翻脸不认人，为什么一定要这样呢？因为这源于SQLite的规范，主键以“_id”为标准。

解决办法有三：

• 第一，建表时根据规范去做；
• 第二，查询时用别名，例如：SELECT id AS _id FROM person；
• 第三，在CursorWrapper里做文章：

如果试图从CursorWrapper里获取“_id”对应的列索引，我们就返回查询结果里“id”对应的列索引即可。