Loader詳解

1.裝載器API概述

2.使用載入器

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

• 一個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的方法們在某個事件發生時介入到數據載入的過程中．

3.回調及完整例子

onLoadFinished

這個方法是在前面已創建的裝載器已經完成其載入過程後被調用．這個方法保證會在應用到裝載器上的數據被釋放之前被調用．在此方法中，你必須刪除所有對舊數據的使用(因為它將很快會被刪除),但是不要自己去釋放它們，因為它們的裝載器會做這些事情．

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

//這個Adapter被用於顯示列表的數據．  
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()：

// 這個Adapter被用於顯示列表的數據．  
SimpleCursorAdapter mAdapter;  
...  
  
public void onLoaderReset(Loader<Cursor> loader) {  
    //此處是用於上面的onLoadFinished()的游標將被關閉時執行， 我們需確保我們不再使用它．  
    mAdapter.swapCursor(null);  
}  

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

public static class CursorLoaderListFragment extends ListFragment  
        implements OnQueryTextListener, LoaderManager.LoaderCallbacks<Cursor> {  
  
    // 這是用於顯示列表數據的Adapter  
    SimpleCursorAdapter mAdapter;  
  
    // 如果非null，這是當前的搜索過慮器  
    String mCurFilter;  
  
    @Override public void onActivityCreated(Bundle savedInstanceState) {  
        super.onActivityCreated(savedInstanceState);  
  
        // 如果列表中沒有數據，就給控制項一些文字去顯示．在一個真正的應用  
        // 中這應用資源中取得．  
        setEmptyText("No phone numbers");  
  
        // 我們在動作欄中有一個菜單項．  
        setHasOptionsMenu(true);  
  
        // 創建一個空的adapter，我們將用它顯示載入後的數據  
        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);  
  
        // 準備loader.可能是重連到一個已存在的或開始一個新的  
        getLoaderManager().initLoader(0, null, this);  
    }  
  
    @Override public void onCreateOptionsMenu(Menu menu, MenuInflater inflater) {  
        // 放置一個動作欄項用於搜索．  
        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) {  
        // 在動作欄上的搜索字串改變時被調用．更新  
        //搜索過濾器，並重啟loader來執行一個新的查詢  
        mCurFilter = !TextUtils.isEmpty(newText) ? newText : null;  
        getLoaderManager().restartLoader(0, null, this);  
        return true;  
    }  
  
    @Override public boolean onQueryTextSubmit(String query) {  
        // 我們不關心這個方法  
        return true;  
    }  
  
    @Override public void onListItemClick(ListView l, View v, int position, long id) {  
        // 寫入你想寫的代碼  
        Log.i("FragmentComplexList", "Item clicked: " + id);  
    }  
  
    // 這是我們想獲取的聯繫人中一行的數據．  
    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) {  
        // 當一個新的loader需被創建時調用．本例僅有一個Loader，  
        //所以我們不需關心ID．首先設置base URI，URI指向的是聯繫人  
        Uri baseUri;  
        if (mCurFilter != null) {  
            baseUri = Uri.withAppendedPath(Contacts.CONTENT_FILTER_URI,  
                    Uri.encode(mCurFilter));  
        } else {  
            baseUri = Contacts.CONTENT_URI;  
        }  
  
        // 現在創建並返回一個CursorLoader，它將負責創建一個  
        // Cursor用於顯示數據  
        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) {  
        // 將新的cursor換進來．(框架將在我們返回時關心一下舊cursor的關閉)  
        mAdapter.swapCursor(data);  
    }  
  
    public void onLoaderReset(Loader<Cursor> loader) {  
        //在最後一個Cursor準備進入上面的onLoadFinished()之前．  
        // Cursor要被關閉了，我們需要確保不再使用它．  
        mAdapter.swapCursor(null);  
    }  
}  

參考地址:http://blog.csdn.net/llp1992/article/details/40630361