1. 程式人生 > >完美Android Cursor使用例子(Android資料庫操作)

完美Android Cursor使用例子(Android資料庫操作)

完美Android Cursor使用例子(Android資料庫操作),Android 使用的資料庫是SQLite資料庫,對於資料庫記錄的操作,可以使用Cursor(遊標)來進行。


1. 關於 Cursor


在你理解和使用 Android Cursor 的時候你必須先知道關於 Cursor 的幾件事情:
Cursor 是每行的集合。
使用 moveToFirst() 定位第一行。
你必須知道每一列的名稱。
你必須知道每一列的資料型別。
Cursor 是一個隨機的資料來源。
所有的資料都是通過下標取得。
Cursor 位於 android.database.Cursor類,可見出它的設計是基於資料庫服務產生的。
在Android 查詢資料是通過Cursor 類來實現的。當我們使用 SQLiteDatabase.query()方法時,就會得到Cursor物件, Cursor所指向的就是每一條資料。




2. 關於 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()
移動游標到上一行


3. 小例子:
(1) 為空的Cursor的判斷
if (cur.moveToFirst() == false)
{
//為空的Cursor
return;
}


(2) 訪問 Cursor 的下標獲得其中的資料


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


(3)迴圈 Cursor 取出需要的資料


while(cur.moveToNext())
{
//游標移動成功
//把資料取出
}


當cur.moveToNext() 為假時將跳出迴圈,即Cursor資料迴圈完畢。


如果你喜歡用 for 迴圈而不想用While 迴圈可以使用Google 提供的幾下方法:
isBeforeFirst()
返回遊標是否指向之前第一行的位置


isAfterLast()
返回遊標是否指向第最後一行的位置


isClosed()
如果返回 true 即表示該
遊戲
標己關閉


有了以上的方法,可以如此取出資料:


AbstractCursor
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);
}


4.  另外,還有幾個己知的子類,分別為:


AbstractWindowedCursor
CrossProcessCursor
CursorWrapper
MatrixCursor
MergeCursor
MockCursor
SQLiteCursor


5. 可以參考Android原始碼中的RingtoneManager.java(屬於framework層), SoundRecorder應用程式來理解,看看它們是如何運用的。
網上另一篇
cursor查詢、更新本地資料庫的操作吧。先舉個例子:
 
Cursor c = getContentResolver.query(uri , String[ ] , where , String[ ] , sort);
這條語句相信大家一定經常看到用到,檢視sdk幫助文件也很容易找到其中五個引數的意思
第一個引數:是一個URI,指向需要查詢的表;
第二個引數:需要查詢的列名,是一個數組,可以返回多個列;
第三個引數:需要查詢的行,where表示需要滿足的查詢條件,where語句裡面可以有?號;
第四個引數:是一個數組,用來替代上面where語句裡面的問號;
第五個引數:表示排序方式;
下面還是用一段程式碼來加強下印象:


Cursor c = getContentResolver.query(Message.Content_URI , 
new String[]{SyncColumns.Server_Id} , SyncColumns.Id+"=?" ,  new String[]{Long.toString(MessageId)} , null);
try {
    if(c.moveToFirst()) {
        return c.getString(0);//0表示返回的行數
    }
    else {
        return null;
    }
}
finally {
    c.close();
}
下面再來看一段更新資料庫的操作:

ContentValues cv = new ContentValues();
cv.put(Body.HTML_Content, newHtmlBody);//第一個引數是列名,第二個引數是要放入的值
String where = Body.Message_Key + "=" + mMessageId;
getContentResolver().update(uri , cv , where , null);
//這裡的四個引數應該很清楚了,uri是表,cv上面要更新的值,where是搜尋行的語句,null是歷史記錄可以為空