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是历史记录可以为空

你可能感兴趣的:(cursor使用例子)