首页 > 代码库 > LoaderManager与CursorLoader用法
LoaderManager与CursorLoader用法
一.基本概念
1.LoaderManager
LoaderManager用来负责管理与Activity或者Fragment联系起来的一个或多个Loaders对象.
每个Activity或者Fragment都有唯一的一个LoaderManager实例(通过getLoaderManager()方法获得),用来启动,停止,保持,重启,关闭它的Loaders,这些功能可通过调用initLoader()/restartLoader()/destroyLoader()方法来实现.
LoaderManager并不知道数据如何装载以及何时需要装载.相反,它只需要控制它的Loaders们开始,停止,重置他们的Load行为,在配置变换或数据变化时保持loaders们的状态,并使用接口来返回load的结果.
2.Loader
Loades负责在一个单独线程中执行查询,监控数据源改变,当探测到改变时将查询到的结果集发送到注册的监听器上.Loader是一个强大的工具,具有如下特点
(1)它封装了实际的数据载入.
Activity或Fragment不再需要知道如何载入数据.它们将该任务委托给了Loader,Loader在后台执行查询要求并且将结果返回给Activity或Fragment.
(2)客户端不需要知道查询如何执行.Activity或Fragment不需要担心查询如何在独立的线程中执行,Loder会自动执行这些查询操作.
这种方式不仅减少了代码复杂度同事也消除了线程相关bug的潜在可能.
(3)它是一种安全的事件驱动方式.
Loader检测底层数据,当检测到改变时,自动执行并载入最新数据.
这使得使用Loader变得容易,客户端可以相信Loader将会自己自动更新它的数据.
Activity或Fragment所需要做的就是初始化Loader,并且对任何反馈回来的数据进行响应.除此之外,所有其他的事情都由Loader来解决.
二.异步Loader的实现原理
(1)执行异步载入的任务.为了确保在一个独立线程中执行载入操作,Loader的子类必须继承AsyncTaskLoader<D>而不是Loader<D>类.
AsyncTaskLoader<D>是一个抽象Loader,它提供了一个AsyncTask来做它的执行操作.
当定义子类时,通过实现抽象方法loadInBackground方法来实现异步task.该方法将在一个工作线程中执行数据加载操作.
(2)在一个注册监听器中接收载入完成返回的结果.
对于每个Loader来说,LoaderManager注册一个OnLoadCompleteListener<D>,该对象将通过调用onLoadFinished(Loader<D> loader, D result)方法使Loader将结果传送给客户端.
Loader通过调用Loader#deliverResult(D result),将结果传递给已注册的监听器.
三.Loader三种不同状态.
已启动: 处于已启动状态的Loader会执行载入操作,并在任何时间将结果传递到监听器中.已启动的Loader将会监听数据改变,当检测到改变时执行新的载入. 一旦启动,Loader将一直 处在已启动状态,一直到转换到已停止和重置,这是唯一一种onLoadFinished永远都会调用的状态。
已停止: 处于已停止状态的Loader将会继续监听数据改变,但是不会将结果返回给客户端.在已停止状态,Loader可能被启动或者重启.
重置: 当Loader处于重置状态时,将不会执行新的载入操作,也不会发送新的结果,也不会检测数据变化.
当一个Loader进入重置状态,它必须解除对应的数据引用,方便垃圾回收(客户端也必须确定,在Loader无效之后,移除了所有对该数据的引用).
通常,重置Loader不会两次调用.然而,在某些情况下他们可能会启动,所以如果必要的话,它们必须能够适时重置.
四.接收Loader数据改变的通知.
必须有一个观察者接受数据源改变的通知.
Loader必须实现这些Observer其中之一(ContentObserver,BroadcastReceiver等),来检测底层数据源的改变.
当检测到数据改变,观察者必须调用Loader#onContentChanged().在该方法中执行两种不同操作:
(1)如果Loader已经处于启动状态,就会执行一个新的载入操作;
(2)设置一个flag标识数据源有改变,这样当Loader再次启动时,就知道应该重新载入数据了.
五.CursorLoader实现LoaderManager.LoaderCallbacks接口方法.接口声明及使用如下:
public interface LoaderCallbacks<D> {
public Loader<D> onCreateLoader(int id, Bundle args);
public void onl oadFinished(Loader<D> loader, D data);
public void onl oaderReset(Loader<D> loader);
}
onCreateLoader方法将在创建Loader时候调用,此时需要提供查询的配置,如监听一个URI.
这个方法会在loader初始化的时调用,即调用下面的代码时调用:
getLoaderManager().initLoader(id, bundle, loaderCallbacks);
initLoader函数原型为:
<D> Loader<D> android.app.LoaderManager.initLoader(int id, Bundle bundle, LoaderCallbacks<D> loaderCallbacks);
第1个参数loader的ID,可自定义一个常量值,便于实现多个Loader;
第2个参数一般置null;
第3个参数是实现了LoaderManager.LoaderCallbacks实现类对象.
onLoadFinished方法,在Loader完成任务后调用,一般在此读取结果.
onLoaderReset方法是在配置发生变化时调用,一般调用下面的代码后调用:
getLoaderManager().restartLoader(id, bundle, loaderCallbacks);
restartLoader方法参数同initLoader,重新初始化loader之后,需要用来释放对前面loader查询到的结果引用.
六.一个具体监听通话记录的示例
在Activity中onCreate调用
CallLogsLoaderListener callLogsCallback = new CallLogsLoaderListener(this);
getLoaderManager().initLoader(0, null, callLogsCallback);
在onDestroy调用
getLoaderManager().destroyLoader(0);
配置权限
<uses-permission android:name="android.permission.WRITE_CALL_LOG" />
<uses-permission android:name="android.permission.READ_CALL_LOG" />
具体的类实现
import android.app.LoaderManager; import android.content.Context; import android.content.CursorLoader; import android.content.Loader; import android.database.Cursor; import android.database.CursorWrapper; import android.os.Bundle; import android.provider.CallLog; import android.util.Log; public class CallLogsLoaderListener implements LoaderManager.LoaderCallbacks<Cursor> { private Context mContext; public CallLogsLoaderListener(Context context) { mContext = context; } @Override public Loader<Cursor> onCreateLoader(int id, Bundle args) { CursorLoader loader = new CursorLoader(mContext, CallLog.Calls.CONTENT_URI, null, null, null, null) { @Override public Cursor loadInBackground() { Cursor cursor = super.loadInBackground(); if (cursor == null) return null; CallLogsCursor callLogsCursor = new CallLogsCursor(cursor); return callLogsCursor; } }; return loader; } @Override public void onl oadFinished(Loader<Cursor> loader, Cursor data) { } @Override public void onl oaderReset(Loader<Cursor> loader) { } public class CallLogsCursor extends CursorWrapper { public CallLogsCursor(Cursor cursor) { super(cursor); int nameIndex = cursor.getColumnIndex(CallLog.Calls.CACHED_NAME); int numberIndex = cursor.getColumnIndex(CallLog.Calls.NUMBER); int typeIndex = cursor.getColumnIndex(CallLog.Calls.TYPE); int dateIndex = cursor.getColumnIndex(CallLog.Calls.DATE); int durationIndex = cursor.getColumnIndex(CallLog.Calls.DURATION); // 从游标的最后索引往前查询,因为最新的通话记录在最后 for (cursor.moveToLast(); !cursor.isBeforeFirst(); cursor .moveToPrevious()) { // 姓名 String name = cursor.getString(nameIndex); // 号码 String number = cursor.getString(numberIndex); // 类型 int type = cursor.getInt(typeIndex); // 日期 long date = cursor.getLong(dateIndex); // 通话时长 int duration = cursor.getInt(durationIndex); Log.d("debug", "name=" + name + ", number=" + number + ", type=" + type + ", date=" + date + ", duration=" + duration); } } } }
LoaderManager与CursorLoader用法