android中Cursor類

轉載：自http://www.cnblogs.com/penghuster/p/5001679.html，作者新手醬油

使用過 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() 
  移動光標到上一行

下面來看看一小段代碼：

 

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

MatrixCursor

ContentProvider對外共享數據的時候的query()方法是需要一個cursor的。 
但是當ContentProvider不是從數據庫中去的數據，而又需要返回cursor的時候就需要MatrixCursor。

ContentProvider對外共享數據的時候的query()方法是需要一個cursor的，

但是如果沒有數據庫，而項目又需要從ContentProvider讀取數據的時候怎麼辦？

更糟糕的是其他方法操作也都是需要cursor的。

此時就需要MatrixCursor了。相當有趣，它相當於爲你模擬了一個表。

 

@Override
 
public Cursor query(Uri uri, String[] projection, String selection,
   String[] selectionArgs, String sortOrder) {
  String[] tableCursor = new String[] { "name", "job", "salary" };
  MatrixCursor cursor = new MatrixCursor(tableCursor);
  cursor.addRow(new Object[] { "1111", "1111", "1111" });
  return cursor;
}