Cursor類在 Android中的使用

在Android SQLite數據庫中，十分重要的概念。Cursor（游標）提供了一種對從表中檢索出的數據進行操作的靈活手段，就本質而言，Cursor（游標）實際上是一種能從包括多條數據記錄的結果集中每次提取一條記錄的機制。今天特地將它單獨拿出來談，加深自己和大家對Android 中使用 Cursor 的理解。



1. 關於 Cursor



在你理解和使用 Android Cursor 的時候你必須先知道關於 Cursor 的幾件事情：
Cursor 是每行的集合。
使用 moveToFirst() 定位第一行。
你必須知道每一列的名稱。
你必須知道每一列的數據類型。
Cursor 是一個隨機的數據源。
所有的數據都是通過下標取得。
Cursor 位於 android.database.Cursor類，可見出它的設計是基於數據庫服務產生的。
在Android 查詢數據是通過Cursor 類來實現的。當我們使用 SQLiteDatabase.query()方法時，就會得到Cursor對象， Cursor所指向的就是每一條數據。



2. 關於Cursor 的重要方法：



close()
關閉游標，釋放資源
copyStringToBuffer(intcolumnIndex, CharArrayBuffer buffer)


在緩沖區中檢索請求的列的文本，將將其存儲
getColumnCount()


返回所有列的總數
getColumnIndex(StringcolumnName);


返回指定列的名稱，如果不存在返回-1
getColumnIndexOrThrow(StringcolumnName);


從零開始返回指定列名稱，如果不存在將拋出IllegalArgumentException 異常。
getColumnName(intcolumnIndex);


從給定的索引返回列名
getColumnNames();


返回一個字符串數組的列名
getCount();


返回Cursor 中的行數
moveToFirst();


移動光標到第一行
moveToLast();


移動光標到最後一行
moveToNext();


移動光標到下一行
moveToPosition(intposition);


移動光標到一個絕對的位置
moveToPrevious();



移動光標到上一行



3. 例子：



（1） 為空的Cursor的判斷

if (cur.moveToFirst() == false)
{
//為空的Cursor
return;
}

（2） 訪問 Cursor 的下標獲得其中的數據

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

（3）循環 Cursor 取出需要的數據

while(cur.moveToNext())
{
//光標移動成功
//把數據取出
}

當cur.moveToNext() 為假時將跳出循環，即Cursor數據循環完畢。
如果你喜歡用 for 循環而不想用While 循環可以使用Google 提供的幾下方法：
isBeforeFirst();


返回游標是否指向之前第一行的位置
isAfterLast();


返回游標是否指向第最後一行的位置
isClosed();


如果返回 true 即表示該游戲標己關閉
有了以上的方法，可以如此取出數據:

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:在Android 查詢數據是通過Cursor 類來實現的。



當我們使用 SQLiteDatabase.query()方法時，就會得到Cursor對象， Cursor所指向的就是每一條數據。Cursor 位於 android.database.Cursor類，可見出它的設計是基於數據庫服務產生的。