Cursor

關於 Cursor

在你理解和使用 Android Cursor 的時候你必須先知道關於 Cursor 的幾件事情：
Cursor 是每行的集合。
使用 moveToFirst() 定位第一行。
你必須知道每一列的名稱。
你必須知道每一列的數據類型。
Cursor 是一個隨機的數據源。
所有的數據都是通過下標取得。

關於 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()
移動光標到上一行

下面來看看一小段代碼：


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


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

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

現在讓我們看看如何循環 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);
}

Tip:在Android 查詢數據是通過Cursor 類來實現的。當我們使用 SQLiteDatabase.query()方法時，就會得到Cursor對象， Cursor所指向的就是每一條數據。結合ADO.net 的知識可能好理解一點。

Cursor 位於 android.database.Cursor類，可見出它的設計是基於數據庫服務產生的。

另外，還有幾個己知的子類，分別爲：

AbstractWindowedCursor
CrossProcessCursor
CursorWrapper
MatrixCursor
MergeCursor
MockCursor
SQLiteCursor