重啟裝載器
當你使用initLoader()時,如果指定ID的裝載器已經存在,則它使用這個裝載器.如果不存在呢,它將建立一個新的.但是有時你卻是想丟棄舊的然後開始新的資料.
要想丟棄舊資料,你應使用restartLoader().例如,下面這個SearchView.OnQueryTextListener的實現在使用者查詢發生改變時重啟了裝載器,裝載器於是需重啟從而能使用新的搜尋過慮來進行一次新的查詢.
public boolean onQueryTextChanged(String newText) { // 當動作欄的搜尋字串發生改時被調用. // 更新搜尋過慮,然後重新啟動裝載利用這個新過慮進行新的查詢. mCurFilter = !TextUtils.isEmpty(newText) ? newText : null; getLoaderManager().restartLoader(0, null, this); return true;}使用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");}