完美Android Cursor使用例子（Android数据库操作）

完美 Android Cursor使用例子（Android数据库操作），Android 使用的数据库是SQLite数据库，对于数据库记录的操作，可以使用Cursor（游标）来进行。


1. 关于 Cursor


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


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


（3）循环 Cursor 取出需要的数据


while(cur.moveToNext())
{
//光标移动成功
//把数据取出
}


当cur.moveToNext() 为假时将跳出循环，即Cursor数据循环完毕。


如果你喜欢用 for 循环而不想用While 循环可以使用Google 提供的几下方法：
isBeforeFirst()
返回游标是否指向之前第一行的位置


isAfterLast()
返回游标是否指向第最后一行的位置


isClosed()
如果返回 true 即表示该 游戏标己关闭


有了以上的方法，可以如此取出数据:


AbstractCursor
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.  另外，还有几个己知的子类，分别为：


AbstractWindowedCursor
CrossProcessCursor
CursorWrapper
MatrixCursor
MergeCursor
MockCursor
SQLiteCursor


5. 可以参考Android源码中的RingtoneManager.java(属于framework层)， SoundRecorder应用程序来理解，看看它们是如何运用的。
网上另一篇
cursor查询、更新本地数据库的操作吧。先举个例子：
 
Cursor c = getContentResolver.query(uri , String[ ] , where , String[ ] , sort);
这条语句相信大家一定经常看到用到，查看sdk帮助文档也很容易找到其中五个参数的意思
第一个参数：是一个URI，指向需要查询的表；
第二个参数：需要查询的列名，是一个数组，可以返回多个列；
第三个参数：需要查询的行，where表示需要满足的查询条件，where语句里面可以有？号；
第四个参数：是一个数组，用来替代上面where语句里面的问号；
第五个参数：表示排序方式；
下面还是用一段代码来加强下印象：


Cursor c = getContentResolver.query(Message.Content_URI , 
new String[]{SyncColumns.Server_Id} , SyncColumns.Id+"=?" ,  new String[]{Long.toString(MessageId)} , null);
try {
    if(c.moveToFirst()) {
        return c.getString(0);//0表示返回的行数
    }
    else {
        return null;
    }
}
finally {
    c.close();
}
下面再来看一段更新数据库的操作：

ContentValues cv = new ContentValues();
cv.put(Body.HTML_Content, newHtmlBody);//第一个参数是列名，第二个参数是要放入的值
String where = Body.Message_Key + "=" + mMessageId;
getContentResolver().update(uri , cv , where , null);
//这里的四个参数应该很清楚了，uri是表，cv上面要更新的值，where是搜索行的语句，null是历史记录可以为空