android 資料庫之Cursor

使用過 SQLite 資料庫的童鞋對 Cursor
應該不陌生，如果你是搞.net 開發你大可以把Cursor理解成 Ado.net
中的資料集合相當於dataReader。今天特地將它單獨拿出來談，加深自己和大家對Android 中使用 Cursor 的理解。

關於 Cursor

在你理解和使用 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

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