装载器API概述

// 准备装载器．可以重连一个已经存在的也可以启动一个新的．  
getLoaderManager().initLoader(0,null, this);

<span style="font-family:KaiTi_GB2312;">public boolean onQueryTextChanged(String newText) {  
    // 当动作栏的搜索字串发生改时被调用．  
    // 更新搜索过虑，然后重新启动装载利用这个新过虑进行新的查询．  
    mCurFilter = !TextUtils.isEmpty(newText) ? newText : null;  
    getLoaderManager().restartLoader(0, null, this);  
    return true;  
}</span>

// 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");  
}  

//这个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 onLoaderReset(Loader<Cursor> loader) {  
        //此处是用于上面的onLoadFinished()的游标将被关闭时执行， 我们需确保我们不再使用它．  
        mAdapter.swapCursor(null);  
    }  

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);  
    }  
}