Android Loader詳解三：重啟與回調

From：http://blog.csdn.net/nkmnkm/article/details/7252037

 

重啟裝載器

當你使用initLoader()時，如果指定ID的裝載器已經存在，則它使用這個裝載器．如果不存在呢，它將創建一個新的．但是有時你卻是想丟棄舊的然后開始新的數據．

要想丟棄舊數據，你應使用restartLoader()．例如，下面這個SearchView.OnQueryTextListener的實現在用戶查詢發生改變時重啟了裝載器，裝載器於是需重啟從而能使用新的搜索過慮來進行一次新的查詢．

<span style="font-family:KaiTi_GB2312;">public boolean onQueryTextChanged(String newText) {
    // 當動作欄的搜索字串發生改時被調用．
    // 更新搜索過慮，然后重新啟動裝載利用這個新過慮進行新的查詢．
    mCurFilter = !TextUtils.isEmpty(newText) ? newText : null;
    getLoaderManager().restartLoader(0, null, this);
    return true;
}</span>

使用LoaderManager的回調

LoaderManager.LoaderCallbacks是一個回調接口，它使得客戶端可以與LoaderManager進行交互．

裝載器，一般指的是CursorLoader，我們希望在它停止后依然保持數據．這使得應用可以在activity或fragment的 onStop() 和onStart() 之間保持數據，所以當用戶回到一個應用時，它們不需等待數據加載．你使用LoaderManager.LoaderCallbacks 的方法們，在需要時創建新的裝載器，並且告訴應用什么時候要停止使用裝載器的數據．

LoaderManager.LoaderCallbacks 包含以下方法們：

• onCreateLoader() —跟據傳入的ID，初始化並返回一個新的裝載器．

• onLoadFinished() —當一個裝載器完成了它的裝載過程后被調用．

• onLoaderReset() —當一個裝載器被重置而什其數據無效時被調用．

onCreateLoader

當你試圖去操作一個裝載器時(比如，通過initLoader())，會檢查是否指定ID的裝載器已經存在．如果它不存在，將會觸發LoaderManager.LoaderCallbacks 的方法onCreateLoader()．這是你創建一個新裝載器的地方．通常這個裝載器是一個CursorLoader，但是你也可以實現你自己的裝載器．

在下面的例子中，回調方法onCreateLoader() 創建一個CursorLoader．你必須使用構造方法來建立CursorLoader ，構造方法需要向ContentProvider執行一次查詢的完整信息作為參數，它尤其需要：

• uri —要獲取的內容的URI．

• projection —要返回的列組成的列被．傳入null 將會返回所有的列，但這是低效的．

• selection —一個過濾器，表明哪些行將被返回．格式化成類似SQLWHERE 語句的樣子(除了沒有WHERE)．傳入null 將返回所有的行．

• selectionArgs —你可以在selection 中包含一些'?'，它將被本參數的值替換掉．這些值出現的順序與'?'在selection中出現的順序一至．值將作為字符串．

• sortOrder —如何為行們排序．格式化成類似於SQLORDER BY 語句的樣字(除了沒有ORDERBY)．傳入null將使用默認順序，默認順序可能是無順序．

例子：

 // If non-null, this is the current filter the user has provided.
String mCurFilter;
...
public Loader<Cursor> onCreateLoader(int id, Bundle args) {
    // 這里是在需要創建新裝載器時被調用的．
    // 我們只是簡單的擁有一個裝載器，所以我們不需要關心ID.
    // First, pick the base URI to use depending on whether we are
    // currently filtering.
    Uri baseUri;
    if (mCurFilter != null) {
        baseUri = Uri.withAppendedPath(Contacts.CONTENT_FILTER_URI,
                  Uri.encode(mCurFilter));
    } else {
        baseUri = Contacts.CONTENT_URI;
    }
    // Now create and return a CursorLoader that will take care of
    // creating a Cursor for the data being displayed.
    String select = "((" + Contacts.DISPLAY_NAME + " NOTNULL) AND ("
            + Contacts.HAS_PHONE_NUMBER + "=1) AND ("
            + Contacts.DISPLAY_NAME + " != '' ))";
    return new CursorLoader(getActivity(), baseUri,
            CONTACTS_SUMMARY_PROJECTION, select, null,
            Contacts.DISPLAY_NAME + " COLLATE LOCALIZED ASC");
}