在你理解和使用 Android Cursor 的時候你必須Crowdsourced Security Testing道關於 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)
{
//為空白的Cursorreturn;
}
訪問 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 即表示該遊戲標己關閉
有了以上的方法,可以如此取出資料
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類,可見出它的設計是基於資料庫服務產生的。
另外,還有幾個己知的子類,分別為:
- AbstractCursor
- AbstractWindowedCursor
- CrossProcessCursor
- CursorWrapper
- MatrixCursor
- MergeCursor
- MockCursor
- SQLiteCursor