Android Cursor的一些浅显见解

一、Cursor的数据模型

之前一直搞不懂Cursor的数据模型是怎么样的，等到看到下面别人博客中把Cursor比作.net中的DataReader才明白，原来是这么回事。但是没 学过.Net的同志可能还是不明白Cursor是怎么一回事，怎么取它的数据，和它的数据为什么那么取。

上面的表代表的是一个cursor对象。

当我们用query方法查询到的是一个指向cursor对象第一行的前面一行数据，即上图中的空行。所以我们使用cursor.moveToNext()方法时，是指向cursor的第一行数据，而不是第二行。

如何得到cursor中的数据呢？

当我们使用了cursor.movetonext()后，cursor指向了第一行数据，由于是数据库中的表，所以每一行每一列都有对应的数据类型和列名。

当我们要取出cursor对象中的一个对应的数据，首先我们要先确定它的数据类型，用cursor.getxxx()。xxx代表的是你要取出的数据的数据类型，当前我们要取出第一行的“列名2”的数据。就可以用cursor.getString()。

然后我们确定了数据类型后，肯定要确定列名，所以我们要得到cursor对象中的列名，用cursor.getColumnIndex("列名")来获得。

这样我们要取出第一行第二列的数据时，就可以用cursor.getString(cursor.getColumnIndex("列名2"))来获得。

取第二行的数据只要继续cursor.moveToNext()，到了第二行后，跟取第一行的数据是一样的。

二、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