android中cursor的使用

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應用程序來理解,看看它們是如何運用的。

 

摘自 TQUDING的專欄

發佈留言