使用過 SQLite 數據庫對 Cursor 應該不陌生,這里單獨拿出來談一下,加深對Android SQLite中使用 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. 訪問 Cursor 的下標獲得其中的數據
cursor.moveToLast(); last = cursor.getInt(cursor.getColumnIndex("Id")); Log.i("nowamagicdb", "last_id=>" + last);
2. 循環 Cursor 取出我們需要的數據
if (cursor.getCount() > 0) { List<NowaMagic> myList = new ArrayList<NowaMagic> (cursor.getCount()); while (cursor.moveToNext()) { myList.add(parse(cursor)); } return myList; }
當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); }
在Android 查詢數據是通過Cursor 類來實現的。當我們使用 SQLiteDatabase.query()方法時,就會得到Cursor對象, Cursor所指向的就是每一條數據。
Cursor 位於 android.database.Cursor類,可見出它的設計是基於數據庫服務產生的。