
转载:
使用过 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类,可见出它的设计是基于数据库服务产生的。
另外,还有几个己知的子类,分别为:
ContentProvider对外共享数据的时候的query()方法是需要一个cursor的。
但是当ContentProvider不是从数据库中去的数据,而又需要返回cursor的时候就需要MatrixCursor。
但是当ContentProvider不是从数据库中去的数据,而又需要返回cursor的时候就需要MatrixCursor。
ContentProvider对外共享数据的时候的query()方法是需要一个cursor的,
但是如果没有数据库,而项目又需要从ContentProvider读取数据的时候怎么办?
更糟糕的是其他方法操作也都是需要cursor的。
此时就需要MatrixCursor了。相当有趣,它相当于为你模拟了一个表。
@Override public Cursor query(Uri uri, String[] projection, String selection,
String[] selectionArgs, String sortOrder) {
String[] tableCursor = new String[] { "name", "job", "salary" };
MatrixCursor cursor = new MatrixCursor(tableCursor);
cursor.addRow(new Object[] { "1111", "1111", "1111" });
return cursor;
}