ContentObserver, 觀察 ContentProvider 的更新

當我們需要對 ContentProvider 的內容更新做出即時的反應，可以用 ContentObserver 來達到監控的效果。

用起來還蠻簡單的，實做一個 ContentObserver 以後，用 ContentResolver 來註冊一個 observer。

private class MyObserver extends ContentObserver {
 public MyObserver(Handler handler)
 {
  super(handler);
 }

 /**
  * {@inheritDoc}
  * @see ContentObserver#onChange(boolean)
  */
 public void onChange(boolean selfChange)
 {
  Log.d("MyObserver", String.format("onChange: %s", selfChange?"1":"0"));
 }
}

ContentResolver cr = getContentResolver();
cr.registerContentObserver(Events.CONTENT_URI, false,
 new MyObserver(new Handler()));

Observer 中除了 constructor，我們只要 override onChange 就可以了。當目標內容有改變並通知時，onChange 就會被呼叫。

有個問題是，我不知道為什麼我實際上在使用的時候，每次資料有變更 onChange 都會被呼叫兩次。目前因為資料的變動週期不短，所以我對每個 onChange 都做出反應不會有什麼問題，但是如果遇到資料更新頻率很高的應用時，也許可以配合 PendingIntent (FLAG_UPDATE_CURRENT, FLAG_NO_CREATE) 來做延後的合併處理。

return values of Android Service onStartCommand

實做 Service 時，最重要的應該就是 onStartCommand 的實作了吧，當其他 context 呼叫 startService 時，這個函數都會被呼叫。

onStartCommand 的回傳值可以有 4 種，分別是 START_NOT_STICKY, START_REDELIVER_INTENT, START_STICKY 跟 START_STICKY_COMPATIBILITY。

若回傳 START_NOT_STICKY，表示這個服務不需要一直存留，當 Service 因其他程序需要記憶體砍掉以後，除非有另一次的 startService 呼叫，不然系統不會幫你重新執行 Service。

回傳 START_REDELIVER_INTENT 時，若 Service 被砍掉以後，系統會嘗試使用當初呼叫 startService 的 intent 來重新啟動這個 Service。

START_STICKY 跟 START_REDELIVER_INTENT 類似，但並不會保留上次用來開啟服務的 intent，也就是說如果 service 被系統砍掉後重開，被砍掉到重新啟動中間如果沒有 startService 來傳遞新的 intent，送進來的 intent 就有可能為 null，所以如果在 onStartCommand 裡面需要讀取 intent 裡的 bundle 一定要先確認 intent 是否為 null。

最後一個 START_STICKY_COMPATIBILITY，跟 START_STICKY 一樣，但根據官方的文件，使用這個 return code 時當 service 被砍掉後系統不一定會再呼叫一次 onStartCommand。也就是說如果是 sticky 的話系統一定會再 reschedule 一個 onStartCommand 嗎.?

Refs:
http://developer.android.com/reference/android/app/Service.html

query content provider with LIMIT

在 query ContentProvider 的時候要用 limit 的話，直接加在 sortOrder 後面就可以了。

Cursor c = cr.query(
 Uri.parse(uri),
 INS_PROJECTION,
 Instances.CALENDAR_ID + "=" + cal_id,
 null,
 "limit 1"
)

SimpleCursorAdapter & _id

基本上 Android 裡面的 Adapter 的工作就是一個將 "Item" (包括 data, meta-data) 包裝成 item view 的類別.

ListView 在 render 的時候會向 Adapter 要一個一個 view 用來表示每個資料.

SimpleCursorAdapter 是把 Cursor 包裝起來, 用來產生 listview 需要顯示的一個個項目。值得一提的是，Cursor 代表的資料需要一個 "_id" 的欄位, 用來當作 onListItemClick 的識別碼，也就是第三個參數。

所以在做查詢的時候都要 Projection 記得選 _ID，不然會噴 IllegalArgumentException。

Ref:

http://developer.android.com/reference/android/widget/SimpleCursorAdapter.html

http://developer.android.com/reference/android/widget/Adapter.html