[高级]Android中的Loaders机制

Loaders机制在Android 3.0版本后引入。Loaders机制使一个Activity或者一个Fragment更加容易异步加载数据。Loaders有如下的特性:

Ø  它们适用于任何Activity和Fragment;

Ø  它们提供了异步加载数据的机制;

Ø  它们检测数据源,当数据源内容改变时它们能够传递新的结果;

Ø  当配置改变后需要重新创建时,它们会重新连接到最后一个loader的游标。这样,它们不需要重新查询它们的数据。

1 Loader API 总结

在app里可以使用与loaders相关的很多的类和接口。总结如下:


Class/Interface


描述


LoaderManager


一个与Activity和Fragment有关联的抽象类,用于管理一个或多个Loader实例。这有助于app管理长运行操作。使用它的最显著的例子是CursorLoader。每个Activity或Fragment只能有一个LoaderManager。而一个LoaderManager可以有多个loaders。


LoaderManager.LoaderCallbacks


提供给客户端的一个callback接口,用于和LoaderManager进行交互。例如,你可以使用onCreateLoader() callback来创建一个新的loader。


AsyncTaskLoader


一个抽象Loader,提供一个AsyncTask进行工作。


CursorLoader


AsyncTaskLoader的子类,用于向ContentResover请求,返回一个Cursor。这个类以标准的游标查询方式实现了Loader协议,建立了AsyncTaskLoader,使用一个后台线程来进行游标查询,不会阻塞app的UI。因此,使用这个loader是从ContentProvider加载异步数据的最好的方式。

上述的class和interface是你在app里实现一个loader所需要的组件。你不必使用所有的组件,但是你通常需要一个LoaderManager的引用(用于初始化一个loader)和一个Loader实现类(例如CursorLoader)。

2 在APP里使用Loaders

一个App里,典型的使用loaders包含的内容如下:

一个Activity或一个Fragment。

一个LoaderManager的实例。

一个CursorLoader,从一个ContentProvider里加载数据。

一个LoaderManager.LoaderCallbacks的实现。在这你创建新的loader,和管理已经存在的loaders。

一种显示loader加载数据的方式,例如SimpleCursorAdapter。

一种数据源,例如一个Conterprovider(当使用CursorLoader)。

2.1 启动一个Loader

在一个Activity或Fragment里,LoaderManager管理一个或多个loader实例。每个Activity或Fragment只有一个LoaderManager。

你可要在Activity里的onCreate()方法里,或者在Fragment里的onActivityCreated()方法里初始化一个loader。例如:

// Prepare the loader.  Either re-connect with an existing one,
// or start a new one.
getLoaderManager().initLoader(0,null, this);

initLoader()方法有三个参数:

Ø  一个标志loader的ID。

Ø  提供给loader构造函数的参数,可选。

Ø  一个LoaderManager.LoaderCallbacks的实现。

initLoader()的调用确保了一个loader被初始化和激活。它有两种结果:

如果标志loader的ID已经存在,则最后创建的loader被复用。

如果标志loader的ID不存在,initLoader()会激发LoaderManager.LoaderCallbacks的方法onCreateLoader()。

在这两种情形下,给定的LoaderManager.LoaderCallbacks实例被关联到loader,并且当loader状态变化时被调用。如果调用者正处于其开始状态并且被请求的loader已经存在,且已产生了数据,那么系统立即调用onLoadFinished()(在initLoader()调用期间),所以你必须准备好这种情况的发生。

记住,intiLoader()会返回一个创建的loader,但是你不需要来获取它的引用。LoadeManager会自动管理loader的生命周期。LoaderManager会开始loading,结束loading,维护loader的状态,以及相关的内容。这意味着,你几乎不用直接和loaders进行交互。当有特定事件发生时,你仅仅需要使用LoaderManager.LoaderCallbacks方法来干预loading的过程。

2.2 重启一个loader

当你调用一个initLoader(),如上述所示,你会得到一个ID已经存在的loader,或者创建一个新的loader。但是有时候,你想丢弃掉你的旧数据,重新开始。

要丢弃掉你的旧数据,你要调用restartLoader()。例如,SearchView.OnQueryTextListener的实现重启了loader,当用户的查询发生变化时。loader需要重启,是由于它要使用修改过的搜索过滤器来进行新的查询:

public boolean onQueryTextChanged(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;
  }

2.3 使用LoaderManagerCallbacks

LoaderManager.LoaderCallbacks是callback接口,给client提供与LoaderManager交互的接口。

Loaders,特别是CursorLoader,在被停止后期望能够维持它们的数据。这允许apps在actvitiy或fragemnt的onStop()和onStart()方法里能够保持它们的数据,它们不需要等待数据重新被加载。你使用LoaderManager.LoaderCallbacks方法,知道什么时候该创建一个新的loader,告诉apps什么时候该停止使用一个loader的数据。

LoaderManager.LoaderCallbacks包含了三个方法:

onCreateLoader()--- 实例化和返回一个新创建的给定ID的loader

onLoadFinished()--- 当一个创建好的loader完成了load,调用此函数

onLoaderReset()--- 当一个创建好的loader要被reset,调用此函数,这样导致它的数据无效

2.3.1 onCreateLoader

当你尝试访问一个loader(例如,通过initLoader()),它会检查给定的loader的ID是否存在。如果不存在,它会触发LoaderManager.LoaderCallbacks里的方法onCreateLoader(),来创建一个新的loader。典型的例子是CursorLoader。

在这个例子里,onCreateLoader()回调函数创建一个CursorLoader。你必须使用CursorLoader的构造函数,它需要一些额外的信息用于查询一个ContentProvider。它需要:

uri--- 取得内容的URI。

projection--- 要返回的列的list。传递null则返回所有的列,这种做法不够高效。

selectionArgs--- 你也许要在selection里包含 ?s,被selectionArgs里的值替换。

sortOrder--- 行的排序由SQL ORDER BY语句来格式化。传递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");
  }

2.3.2 onLoadFinished

当一个创建好的loader结束了它的load,此方法被调用。这个方法确保在释放loader维持的数据之前调用。在这个点上,你应当移除所有对旧数据的使用(因为旧数据不久就要被释放),不用释放旧数据,loader会完成旧数据的释放。

loader一旦知道app不再使用它,它就会释放掉数据。例如,如果数据是来自CursorLoader里的一个cursor,你不应当自己调用close()。如果一个cursor正在放置到一个CursorAdapter,你应当使用swapCursor()方法,这样旧的Cursor就不会被关掉。

例如:

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

2.3.3onLoaderReset

当建立好的loader正在被重启时,此方法被调用,这样让loader的数据置于无效状态。这个回调函数让你发现什么时候数据要被释放掉,在这个点上你可要移除对它的引用。

例如:

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

3 样例

这个样例是一个Fragment的实现,它使用ListView显示了通讯录查询的结果,使用CursorLoader来管理通讯录Provider的查询。app若需要访问通讯录,你需要在mainfest里添加权限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);
      }
  }

更多的样例请参考API Demos里的"LoaderCursor"和"LoaderThrottle"。

时间: 2024-08-03 05:27:39

[高级]Android中的Loaders机制的相关文章

Android中的Parcel机制 实现Bundle传递对象

Android中的Parcel机制    实现了Bundle传递对象    使用Bundle传递对象,首先要将其序列化,但是,在Android中要使用这种传递对象的方式需要用到Android Parcel机制,即,Android实现的轻量级的高效的对象序列化和反序列化机制. JAVA中的Serialize机制,译成串行化.序列化……,其作用是能将数据对象存入字节流当中,在需要时重新生成对象.主要应用是利用外部存储设备保存对象状态,以及通过网络传输对象等.        Android中的新的序列

深入解析Android中Handler消息机制

Android提供了Handler 和 Looper 来满足线程间的通信.Handler先进先出原则.Looper类用来管理特定线程内对象之间的消息交换(MessageExchange).Handler消息机制可以说是Android系统中最重要部分之一,所以,本篇博客我们就来深入解析Android中Handler消息机制. Handler的简单使用 为什么系统不允许子线程更新UI 因为的UI控件不是线程安全的. 如果在多线程中并发访问可能会导致UI控件处于不可预期的状态,那为什么不对UI控件的访

Android中的消息机制

在分析Android消息机制之前.我们先来看一段代码: public class MainActivity extends Activity implements View.OnClickListener { private TextView stateText; private Button btn; @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); s

android中的多线程机制

Google参考了Windows的消息处理机制,在Android系统中实现了一套类似的消息处理机制.学习Android的消息处理机制,有几个概念(类)必须了解: 1.       Message 消息,理解为线程间通讯的数据单元.例如后台线程在处理数据完毕后需要更新UI,则可发送一条包含更新信息的Message给UI线程. 2.       Message Queue 消息队列,用来存放通过Handler发布的消息,按照先进先出执行. 3.       Handler Handler是Messa

浅析Android中的消息机制(转)

原博客地址:http://blog.csdn.net/liuhe688/article/details/6407225 在分析Android消息机制之前,我们先来看一段代码: 1 public class MainActivity extends Activity implements View.OnClickListener { 2 private TextView stateText; 3 private Button btn; 4 5 @Override 6 public void onC

探索Android中的Parcel机制(上)

一.先从Serialize说起 我们都知道JAVA中的Serialize机制,译成串行化.序列化……,其作用是能将数据对象存入字节流其中,在须要时又一次生成对象.主要应用是利用外部存储设备保存对象状态,以及通过网络传输对象等. 二.Android中的新的序列化机制 在Android系统中,定位为针对内存受限的设备,因此对性能要求更高,另外系统中採用了新的IPC(进程间通信)机制,必定要求使用性能更出色的对象传输方式.在这种环境下,Parcel被设计出来,其定位就是轻量级的高效的对象序列化和反序列

浅析Android中的消息机制-解决:Only the original thread that created a view hierarchy can touch its views.

在分析Android消息机制之前,我们先来看一段代码: [html] view plaincopyprint? public class MainActivity extends Activity implements View.OnClickListener { private TextView stateText; private Button btn; @Override public void onCreate(Bundle savedInstanceState) { super.onC

探索Android中的Parcel机制(下)

上一篇中我们透过源码看到了Parcel背后的机制,本质上把它当成一个Serialize就可以了,只是它是在内存中完成的序列化和反序列化,利用的是连续的内存空间,因此会更加高效. 我们接下来要说的是Parcel类如何应用.就应用程序而言,最常见使用Parcel类的场景就是在Activity间传递数据.没错,在Activity间使用Intent传递数据的时候,可以通过Parcelable机制传递复杂的对象. 在下面的程序中,MyColor用于保存一个颜色值,MainActivity在用户点击屏幕时将

浅析Android中的消息机制(转)

在分析Android消息机制之前,我们先来看一段代码: public class MainActivity extends Activity implements View.OnClickListener { private TextView stateText; private Button btn; @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); s