重啟裝載器
當你使用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");}