Cursor 游标
Android使用的数据库是SQLite数据库,对于数据库记录的操作,可以使用Cursor来进行。
Cursor (1)是每行的集合;(2)使用moveToFirst()定位第一行;(3)必须知道每一列的名称;(4)必须知道每一列的数据类型;(5)是一个随机的数据源;(6)所有的数据都是通过下标取得;(7)Cursor位于android.database.Cursor类,可见它的设计是基于数据库服务产生的;(8)在Android查询数据是通过Cursor类来实现的。当我们使用SQLiteDatabase.query()方法时,就会得到Cursor对象,Cursor所指向的就是每一条数据。
关于Cursor的重要方法:
close() ——->关闭游标,释放资源
copyStringToBuffer(int columnIndex,CharArrayBuffer buffer) ——->在缓冲区中检索请求的列的文本,将其存储
getColumnCount() ——–>返回所有列的总数
getColumnIndex(String columnName) ——–>返回指定列的名称 ,如果不存在返回-1
getColumnIndexOrThrow(String columnName) ——>从零开始返回指定列名称,如果不存在将抛出IIlegalArgumentException异常
getColumnNames() ——–>返回一个字符串数组的列名
getCount() ——–>返回Cursor中的行数
moveToFirst() ——–>移动光标到第一行
moveToLast() ———>移动光标到最后一行
moveToNext() ———>移动光标到下一行
moveToPosition(int position) ——->移动光标到一个绝对的位置
moveToPrevious() ——–>移动光标到上一行
小例子:
(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);
}
另外,还有几个己知的子类,分别为:
AbstractWindowedCursor
CrossProcessCursor
CursorWrapper
MatrixCursor
MergeCursor
MockCursor
SQLiteCursor
可以参考Android源码中的RingtoneManager.java(属于framework层), SoundRecorder应用程序来理解,看看它们是如何运用的。
先举个例子:
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是历史记录可以为空