Android数据库操作----Cursor

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默认是行的集合：

查询出来的cursor的初始位置：指向第一条记录的前一个位置的
cursor.moveToFirst（）指向查询结果的第一个位置。
        一般通过判断cursor.moveToFirst()的值为true或false来确定查询结果是否为空。cursor.moveToNext()是用来做循环的，一般这样来用：while(cursor.moveToNext()){ }
cursor.moveToPrevious()是指向当前记录的上一个记录，是和moveToNext相对应的；
cursor.moveToLast()指向查询结果的最后一条记录

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

Cursor.moveToNext();和Cursor.moveToFirst();_一条咸鱼-CSDN博客
作者：小瓜子儿姑娘
链接：https://www.jianshu.com/p/b290eecbd87e
来源：简书
著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。