Loader与LoaderManager
Loader设计用于从数据源加载某类数据(如对象)。数据源可以是磁盘、数据库、ContentProvider、网络或者另一进程。Loader可在不阻塞主线程的情况下获取并发送结果数据给接收者。
loader有三种内置类型:Loader、AsyncTaskLoader和CursorLoader。作为基类,Loader本身没有多大用处。它定义了供LoaderManager与其它loader通讯时使用的API。
AsyncTaskLoader是一个抽象Loader。它使用AsyncTask将数据加载任务转移到其他线程上处理。几乎所有我们创建的有用loader类都是AsyncTaskLoader的一个子类。
CursorLoader通过继承AsyncTaskLoader类,它借助于ContentResolver从ContentProvider加载Cursor。
LoaderManager管理着与loader间的所有通讯,并负责启动、停止和管理与组件关联的Loader生命周期方法。在Activity或Fragment中,我们可以使用getLoaderManager()方法返回一个实例并与之交互。
要初始化Loader,可使用initLoader(int, Bundle, LoaderCallbacks)方法。该方法中的三个参数,第一个是整数类型的loader标识符,第二个是Bundle参数(值可为空),最后一个是LoaderCallbacks接口的实现。
要强制重启现有loader,可使用restartLoader(int, Bundle, LoaderCallbacks)方法。在明确知道或怀疑数据比较陈旧时,我们通常会使用该方法重新加载最新数据。
为什么要实用loader而不直接使用AsyncTask呢?一个最有力说服力的理由是,因设备旋转等原因发生配置更改时,LoaderManager可保证组件的loader及其数据不会丢失。
如果使用AsyncTask加载数据,配置发生改变时,我们必须亲自管理其生命周期并保存它获取的数据。虽然我们经常使用保留的Fragment(使用setRetainInstance(true)方法)解决了这些麻烦问题,但某些场景下,我们还是必须亲自介入并编写对应代码,才能保证一切尽在掌握。
loader的设计目的就是要解决部分(不是全部)这样的恼人问题。配置发送改变后,如果我们初始化一个已完成数据加载的loader,它会立即发送取得的数据,而不是尝试再次获取数据。而且,无论fragment是否保留,它都是这样工作的。这样一来,无需再考虑保留fragment带来的生命周期难题。我们的开发工作也会因此轻松很多。
使用Loader
新建SQLiteCursorLoader 类
package com.huangfei.runtracker;
import android.content.Context;
import android.database.Cursor;
import android.support.v4.content.AsyncTaskLoader;
/**
*SQLiteCursorLoader是CursorLoader框架类的简化版本,可与来自任何数据源的Cursor协同工作.
*该类复制了CursorLoader类的大部分代码,但并不需要使用ContentProvider类。
*/
public abstract class SQLiteCursorLoader extends AsyncTaskLoader<Cursor> {
private Cursor mCursor;//SQLiteCursorLoader可高效加载Cursor,并将其保存在mCursor实例变量中
public SQLiteCursorLoader(Context context) {
super(context);
}
protected abstract Cursor loadCursor();
@Override
public Cursor loadInBackground() {
Cursor cursor = loadCursor();
if(cursor != null){
//保证数据在发送给主线程之前已加载到内存中
cursor.getCount();
}
return cursor;
}
/**
* deliverResult(Cursor)方法负责两件事。
* 如果load启动了(这表示数据可以发送了),超类版本的deliverResult(Cursor)方法会被调用。
* 如果旧的cursor不再需要,它会被关闭以及释放资源。现有的cursor可能会被缓存或重新发送,因此在
* 关闭旧的cursor前,必须确认新旧cursor并不相同。
*/
@Override
public void deliverResult(Cursor data) {
Cursor oldCursor = mCursor;
mCursor = data;
if(isStarted()){
super.deliverResult(data);
}
if(oldCursor != null && oldCursor != data && !oldCursor.isClosed()){
oldCursor.close();
}
}
@Override
protected void onStartLoading() {
if(mCursor != null){
deliverResult(mCursor);
}
if(takeContentChanged() || mCursor == null){
forceLoad();
}
}
@Override
protected void onStopLoading() {
cancelLoad();
}
@Override
public void onCanceled(Cursor data) {
if(data != null && !data.isClosed()){
data.close();
}
}
@Override
protected void onReset() {
super.onReset();
onStopLoading();
if(mCursor != null && !mCursor.isClosed()){
mCursor.close();
}
mCursor = null;
}
}
新建DateLoader 类
package com.huangfei.runtracker;
import android.content.Context;
import android.support.v4.content.AsyncTaskLoader;
/**
* DateLoader可加载任意类型数据,并能帮助子类简化使用AsyncTaskLoader。
* DateLoader类可处理一些任何AsyncTaskLoader子类都能处理的简单任务,而仅把loadInBackground()方法的实现任务留给了自己的子类。
* DateLoader使用D泛型类存储加载的数据实例。
*/
public abstract class DateLoader<D> extends AsyncTaskLoader<D> {
private D mDate;
public DateLoader(Context context) {
super(context);
}
/**
* deliverResult(D)方法先将新数据对象存储起来,然后如果loader以启动,则调用超类的版本的方法将数据发送出去。
*/
@Override
public void deliverResult(D data) {
mDate = data;
if (isStarted()) {
super.deliverResult(data);
}
}
/**
* 检查数据是否已加载,如已加载则立即发送;否则,就调用超类的forceLoad()方法去获取数据。
*/
@Override
protected void onStartLoading() {
if (mDate != null) {
deliverResult(mDate);
} else {
forceLoad();
}
}
}
在Activity或Fragment中调用AsyncTaskLoader
getLoaderManager().initLoader(0, null, this);
...
private static class RunListCursorLoader extends SQLiteCursorLoader{
public RunListCursorLoader(Context context) {
super(context);
}
@Override
protected Cursor loadCursor() {
return RunManager.get(getContext()).queryRuns();
}
}
/**
* 需要创建loader时,LoaderManager会调用onCreateLoader(int, Bundle)方法。如果有多个相同类型的loader,
* 可使用id参数区分它们。而Bundle会保存传入的任何类型参数
*/
@Override
public Loader<Cursor> onCreateLoader(int id, Bundle args) {
return new RunListCursorLoader(getActivity());
}
/**
* 数据在后台一完成加载,onLoadFinished(Loader<Cursor>, Cursor)方法就会在主线程上被调用
*/
@Override
public void onLoadFinished(Loader<Cursor> loader, Cursor cursor) {
RunCursorAdapter adapter = new RunCursorAdapter(getActivity(), (RunCursor)cursor);
setListAdapter(adapter);
}
/**
* 在没有可加载数时,onLoaderReset(Loader<Cursor>)方法会被调用,安全起见,我们设置列表adapter值为空,以停止使用cursor。
*/
@Override
public void onLoaderReset(Loader<Cursor> loader) {
setListAdapter(null);
}