Android cursor的使用

關於 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 即表示該遊戲標己關閉

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

 

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