Android onLoadFinished与onLoaderReset回调详解及实例

//这个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,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,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,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); 
  } 
}