Android loader 詳解

裝載器從android3.0開始引進。它使得在activity或fragment中異步加載數據變得簡單。裝載器具備以下特性：

• 它們對每一個Activity和Fragment都有效。

• 他們提供了異步加載數據的能力。

• 它們監視數據源的一將一動並在內容改變時傳送新的結果。

• 當因爲配置改變而被從新建立後，它們自動重連到上一個加載器的遊標，因此沒必要從新查詢數據。

裝載器API概述

在使用裝載器時，會涉及不少類和接口們，咱們在下表中對它們總結一下： 

Class/Interface	說明
LoaderManager	一個抽像類，關聯到一個Activity或Fragment，管理一個或多個裝載器的實例。這幫助一個應用管理那些與Activity或Fragment的生命週期相關的長時間運行的的操做。最多見的方式是與一個CursorLoader一塊兒使用，然而應用是能夠隨便寫它們本身的裝載器以加載其它類型的數據。 每一個activity或fragment只有一個LoaderManager。可是一個LoaderManager能夠擁有多個裝載器。
LoaderManager.LoaderCallbacks	一個用於客戶端與LoaderManager交互的回調接口。例如，你使用回調方法onCreateLoader()來建立一個新的裝載器。
Loader（裝載器）	一個執行異步數據加載的抽象類。它是加載器的基類。你可使用典型的CursorLoader，可是你也能夠實現你本身的子類。一旦裝載器被激活，它們將監視它們的數據源而且在數據改變時發送新的結果。
AsyncTaskLoader	提供一個AsyncTask來執行異步加載工做的抽象類。
CursorLoader	AsyncTaskLoader的子類，它查詢ContentResolver而後返回一個Cursor。這個類爲查詢cursor以標準的方式實現了裝載器的協議，它的遊標查詢是經過AsyncTaskLoader在後臺線程中執行，從而不會阻塞界面。使用這個裝載器是從一個ContentProvider異步加載數據的最好方式。相比之下，經過fragment或activity的API來執行一個被管理的查詢就不行了。

上面所列的類和接口們是你在你的應用中要實現裝載器時的核心組件。你的每一個裝載器並不必定須要全部的組件，可是你老是須要引用LoaderManager來初始化一個裝載器。後面的章節將向你展現如何使用這些類和接口們。

 

一個使用裝載器的應用會典型的包含以下組件：

• 一個Activity或Fragment．

• 一個LoaderManager的實例．

• 一個加載被ContentProvider所支持的數據的CursorLoader．或者，你能夠從Loader或AsyncTaskLoader實現你本身的裝載器來從其它源加載數據．

• 一個LoaderManager.LoaderCallbacks的實現．這是你建立新的裝載器以及管理你的已有裝載器的引用的地方．

• 一個顯示裝載器的數據的途徑，例如使用一個SimpleCursorAdapter．

• 一個數據源，好比當是用CursorLoader時，它將是一個ContentProvider.
  

啓動一個裝載器

LoaderManager管理一個Activiry或Fragment中的一個或多個裝載器．但每一個activity或fragment只擁有一個LoaderManager．

你一般要在activity的onCreate()方法中或fragment的onActivityCreated()方法中初始化一個裝載器．你能夠以下建立：

// 準備裝載器．能夠重連一個已經存在的也能夠啓動一個新的．
getLoaderManager().initLoader(0,null, this);

initLoader()方法有如下參數：

• 一個惟一ID來標誌裝載器．在這個例子中，ID是0．

• 可選的參數，用於裝載器初始化時(本例中是null)．

• 一個LoaderManager.LoaderCallbacks的實現．被LoaderManager調用以報告裝載器的事件，在這個例子中，類本實現了這個接口，因此傳的是它本身：this．

initLoader()保證一個裝載器被初始化並激活．它具備兩種可能的結果：

• 若是ID所指的裝載器已經存在，那麼這個裝載器將被重用．

• 若是裝載器不存在，initLoader()就觸發LoaderManager.LoaderCallbacks的方法onCreateLoader()．這是你實例化並返回一個新裝載器的地方． 

　　在這兩種狀況中，傳入的LoaderManager.LoaderCallbacks的實現都與裝載器綁定在一塊兒．而且會在裝載器狀態變化時被調用．若是在調用這個方法時，調用者正處於啓動狀態，而且所請求的裝載器已存在併產生了數據，那麼系統會立刻調用onLoadFinished()(也就是說在initLoader()還在執行時)．因此你必須爲這種狀況的發生作好準備．

　　注意initLoader()返回所建立的裝載器，可是你不需保存一個對它的引用．LoaderManager自動管理裝載器的生命．LoaderManager會在須要時開始和中止裝載動做，而且維護裝載器的狀態和它所關聯的內容．這意味着，你不多與裝載器直接交互．你一般都是使用LoaderManager.LoaderCallbacks的方法們在某個事件發生時介入到數據加載的過程當中．

重啓裝載器

當你使用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) { // This is called when a new Loader needs to be created. This // sample only has one Loader, so we don't care about the 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"); }

onLoadFinished

　　這個方法是在前面已建立的裝載器已經完成其加載過程後被調用．這個方法保證會在應用到裝載器上的數據被釋放以前被調用．在此方法中，你必須刪除全部對舊數據的使用(由於它將很快會被刪除),可是不要本身去釋放它們，由於它們的裝載器會作這些事情．

　　裝載器一旦瞭解到應用再也不使用數據時，將立刻釋放這些數據．例如，若是數據是一個從CursorLoader來的遊標，你不該調用遊標的close()．若是遊標被放置在一個CursorAdapter中，你應使用swapCursor()方法，以使舊的遊標不被關閉．例如：

// This is the Adapter being used to display the list's data.
SimpleCursorAdapter mAdapter; ... public void onLoadFinished(Loader<Cursor> loader, Cursor data) { // Swap the new cursor in. (The framework will take care of closing the // old cursor once we return.)
 mAdapter.swapCursor(data); }

onLoaderReset

　　當一個已建立的裝載器被重置從而使其數據無效時，此方法被調用．此回調使你能發現何時數據將被釋放因而你能夠釋放對它的引用．

下面這個實現調用參數爲null的swapCursor()： 

// This is the Adapter being used to display the list's data.
SimpleCursorAdapter mAdapter; ... public void onLoaderReset(Loader<Cursor> loader) { // This is called when the last Cursor provided to onLoadFinished() // above is about to be closed. We need to make sure we are no // longer using it.
    mAdapter.swapCursor(null); } 

例子

　　做爲一個例子，這裏完整實現了一個Fragment顯示一個包含從聯繫人contentprovider 返回查詢數據的ListView的內容的功能．它使用一個CursorLoader來管理對provider的查詢．

　　爲了能從用戶的聯繫人中取得數據，本例的manifest必須包含READ_CONTACTS權限．

public static class CursorLoaderListFragment extends ListFragment implements OnQueryTextListener, LoaderManager.LoaderCallbacks<Cursor> { // This is the Adapter being used to display the list's data.
 SimpleCursorAdapter mAdapter; // If non-null, this is the current filter the user has provided.
 String mCurFilter; @Override public void onActivityCreated(Bundle savedInstanceState) { super.onActivityCreated(savedInstanceState); // Give some text to display if there is no data. In a real // application this would come from a resource.
        setEmptyText("No phone numbers"); // We have a menu item to show in action bar.
        setHasOptionsMenu(true); // Create an empty adapter we will use to display the loaded data.
        mAdapter = new SimpleCursorAdapter(getActivity(), android.R.layout.simple_list_item_2, null, new String[] { Contacts.DISPLAY_NAME, Contacts.CONTACT_STATUS }, new int[] { android.R.id.text1, android.R.id.text2 }, 0); setListAdapter(mAdapter); // Prepare the loader. Either re-connect with an existing one, // or start a new one.
        getLoaderManager().initLoader(0, null, this); } @Override public void onCreateOptionsMenu(Menu menu, MenuInflater inflater) { // Place an action bar item for searching.
        MenuItem item = menu.add("Search"); item.setIcon(android.R.drawable.ic_menu_search); item.setShowAsAction(MenuItem.SHOW_AS_ACTION_IF_ROOM); SearchView sv = new SearchView(getActivity()); sv.setOnQueryTextListener(this); item.setActionView(sv); } public boolean onQueryTextChange(String newText) { // Called when the action bar search text has changed. Update // the search filter, and restart the loader to do a new query // with this filter.
        mCurFilter = !TextUtils.isEmpty(newText) ? newText : null; getLoaderManager().restartLoader(0, null, this); return true; } @Override public boolean onQueryTextSubmit(String query) { // Don't care about this.
        return true; } @Override public void onListItemClick(ListView l, View v, int position, long id) { // Insert desired behavior here.
        Log.i("FragmentComplexList", "Item clicked: " + id); } // These are the Contacts rows that we will retrieve.
    static final String[] CONTACTS_SUMMARY_PROJECTION = new String[] { Contacts._ID, Contacts.DISPLAY_NAME, Contacts.CONTACT_STATUS, Contacts.CONTACT_PRESENCE, Contacts.PHOTO_ID, Contacts.LOOKUP_KEY, }; public Loader<Cursor> onCreateLoader(int id, Bundle args) { // This is called when a new Loader needs to be created. This // sample only has one Loader, so we don't care about the 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"); } public void onLoadFinished(Loader<Cursor> loader, Cursor data) { // Swap the new cursor in. (The framework will take care of closing the // old cursor once we return.)
 mAdapter.swapCursor(data); } public void onLoaderReset(Loader<Cursor> loader) { // This is called when the last Cursor provided to onLoadFinished() // above is about to be closed. We need to make sure we are no // longer using it.
        mAdapter.swapCursor(null); } }

***