Android Loader詳解四：回調及完整例子

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

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

[java] //這個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); 
} 
//這個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()：

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

public void onLoaderReset(Loader<Cursor> loader) {
    //此處是用於上面的onLoadFinished()的遊標將被關閉時執行， 我們需確保我們不再使用它．
    mAdapter.swapCursor(null);
}

例子

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

為了能從使用者的連絡人中取得資料，本例的manifest必須包含READ_CONTACTS許可權．

[java] 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用於顯示資料  www.2cto.com 
        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); 
    } 
} 

 摘自 nkmnkm的專欄