使用Loader加载异步数据

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

代码地址