Android中Cursor類的概念和用法

使用過 SQLite 數據庫的童鞋對 Cursor 應該不陌生，如果你是搞.net 開發你大可以把Cursor理解成 Ado.net 中的數據集合相當於dataReader。今天特地將它單獨拿出來談，加深自己和大家對Android 中使用 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()
  移動光標到上一行

下面來看看一小段代碼：

1. if (cur.moveToFirst() == false)
2. {
3. //為空的Cursor
4. return;
5. }

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

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

現在讓我們看看如何循環 Cursor 取出我們需要的數據

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

當cur.moveToNext() 為假時將跳出循環，即 Cursor 數據循環完畢。

如果你喜歡用 for 循環而不想用While 循環可以使用Google 提供的幾下方法：

• isBeforeFirst()
  返回游標是否指向之前第一行的位置
• isAfterLast()
  返回游標是否指向第最後一行的位置
• isClosed()
  如果返回 true 即表示該游戲標己關閉

有了以上的方法，可以如此取出數據

1. for(cur.moveToFirst();!cur.isAfterLast();cur.moveToNext())
2. {
3. int nameColumn = cur.getColumnIndex(People.NAME);
4. int phoneColumn = cur.getColumnIndex(People.NUMBER);
5. String name = cur.getString(nameColumn);
6. String phoneNumber = cur.getString(phoneColumn);
7. }

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

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

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

• AbstractCursor
• AbstractWindowedCursor
• CrossProcessCursor
• CursorWrapper
• MatrixCursor
• MergeCursor
• MockCursor
• SQLiteCursor

具體詳細的使用方法和解釋可以去參照API，這裡就不過多講述。