LoaderManager源码分析

LoaderManager是与Activity或者Fragment相关联的接口，用于管理与其关联一个或者多个Loader的实例。有助于应用程序长时间管理Activity或者Fragment的生命周期的操作。常见的用途是使用CursorLoader。下面的链接是一个Fragment的完整实现，它显示了一个包含对联系人内容提供者的查询结果的ListView。 它使用CursorLoader来管理提供者上的查询操作。
https://developer.android.com/reference/android/app/LoaderManager.html

总结：
虽然这个类已经看完了，各个方法大致直到是什么意思，但是想要搞明白，还需要看看其它的相关联的类，FragmentController，和它的实现类FragmentHostCallback，FragmentManager，想要查看调用链需要阅读这三个类。

public interface LoaderCallbacks {

       public Loader onCreateLoader(int id, Bundle args);

       public void onLoadFinished(Loader loader, D data);

       public void onLoaderReset(Loader loader);
}

LoaderCallbacks是客户端与管理器的回调接口。

• onCreateLoader：
  实例化并为给定的ID返回一个新的Loader。
  param id要加载的ID
  调用者提供的参数
  return返回一个可以开始加载的新的Loader实例。

• onLoadFinished：
  onCreateLoader创建的加载器完成加载时调用，注意应用程序不允许提交Fragment的事务，因为可能会在保存活动状态后发生，请参阅FragmentManager.openTransaction（）。

这个函数能在释放资源时，能够返回最后一次数据。在这个回调中，应该删除上一次的数据，加载最新的数据，但是不应该去自己去发布数据，由Loader自己去处理，loader只负责管理数据。

不要去做下面的事情：

1. Loader会监听数据的变化，并会通过这个方法通知你，不应该自己去监听数据。例如，如果数据是一个Cursor，并将其放置在CursorAdapter中，则使用CursorAdapter（android.content.Context，android.database.Cursor，int）构造函数，而不传入FLAG_AUTO_REQUERY或FLAG_REGISTER_CONTENT_OBSERVER（即，使用0作为标志参数）。这可以防止CursorAdapter自己观察游标，因为当发生变化时，您将得到一个新的游标在这里再次调用游标。

2. 一旦应用程序不在使用Loader，Loader将释放数据。例如，如果数据是来自CursorLoader的Cursor，则不应该自己调用close（）。如果光标放在CursorAdapter中，则应该使用swapCursor（android.database.Cursor）方法，以便旧的光标未关闭。

Parameters
loader Loader: The Loader that has finished.
data D: The data generated by the Loader.

• onLoaderReset
  在之前创建的加载程序正在重置时调用，从而使其数据不可用。 应用程序应该删除对Loader数据的任何引用。

• initLoader

public abstract  Loader initLoader(int id, Bundle args,
            LoaderManager.LoaderCallbacks callback);

确保加载程序已初始化并处于活动状态。 如果加载器尚不存在，则创建一个加载器（如果活动/片段当前已启动）将启动加载器。 否则，重新使用最后创建的加载器。

在任何情况下，给定的回调都与加载器相关联，并且将在loader状态更改时调用。 如果在调用点处调用者处于启动状态，并且请求的加载器已经存在并且已经生成了它的数据，那么将立即调用onLoadFinished（Loader，D）的回调函数（在这个函数内部），所以你必须准备好 为此发生。

• restartLoader

    public abstract  Loader restartLoader(int id, Bundle args,
            LoaderManager.LoaderCallbacks callback);

manager会新建一个或者重新启动一个存在的Loader，注册回调，（如果当前的Activity或者Fragment启动）开始加载。如果之前已经启动了相同的Id的加载器，在新的Loader加载数据完成时，旧的Loader会被自动销毁。在销毁之前，回调会被发送出来。

• destroyLoader

public abstract void destroyLoader(int id);

停止并删除具有指定id的Loader。如果Loader以前通过onLoadFinished(Loader, Object)向客户端发送过数据，则会调用onLoaderReset（Loader）。

• getLoader

public abstract  Loader getLoader(int id);

如果没有找到匹配的Loader，则返回给定id的Loader或null

• hasRunningLoaders

    public boolean hasRunningLoaders() { return false; }

如果管理的加载器当前正在运行，并且还没有将数据返回给应用程序，则返回true。

LoaderManagerImpl是LoaderManager实现类

这里主要看LoaderManagerImpl实现类和LoaderInfo内部类。

public abstract class LoaderManager {
    public interface LoaderCallbacks {

        public Loader onCreateLoader(int id, Bundle args);

        public void onLoadFinished(Loader loader, D data);

        public void onLoaderReset(Loader loader);
    }

 
    public abstract  Loader initLoader(int id, Bundle args,
            LoaderManager.LoaderCallbacks callback);


    public abstract  Loader restartLoader(int id, Bundle args,
            LoaderManager.LoaderCallbacks callback);

    public abstract void destroyLoader(int id);

    public abstract  Loader getLoader(int id);

    public abstract void dump(String prefix, FileDescriptor fd, PrintWriter writer, String[] args);

    public static void enableDebugLogging(boolean enabled) {
        LoaderManagerImpl.DEBUG = enabled;
    }

    public boolean hasRunningLoaders() { return false; }
}

class LoaderManagerImpl extends LoaderManager {
    static final String TAG = "LoaderManager";
    static boolean DEBUG = false;

    // These are the currently active loaders.  A loader is here
    // from the time its load is started until it has been explicitly
    // stopped or restarted by the application.
//这些是当前活跃的Loader，Loader从开始加载直到它明确的要求被消应用程序停止或者重新开启。
//SparseArrayCompat数据类似与hashMap,使用方法类似与hashMap。
//优点，最高节省50%的缓存。
//缺点就是key只能是Integer类型，value只能是object类型。因此当HshMap()的key是Integer类型时推荐使用SparseArrayCompat()。

    final SparseArrayCompat mLoaders = new SparseArrayCompat();

    // These are previously run loaders.  This list is maintained internally
    // to avoid destroying a loader while an application is still using it.
    // It allows an application to restart a loader, but continue using its
    // previously run loader until the new loader's data is available.
    //这些是以前运行的loader。这个列表在内部维护，避免应用程序正在使用时销毁Loader。允许应用程序重新开启一个loader，但是会继续使用之前的loader直到新的loader加载的数据可用。

//待用的Loader集合
    final SparseArrayCompat mInactiveLoaders = new SparseArrayCompat();

    final String mWho;

    boolean mStarted;
//正在保留中
    boolean mRetaining;
//'保留'是否开始
    boolean mRetainingStarted;

//表示loader正在创建中，createAndInstallLoader方法中体现。
    boolean mCreatingLoader;
    FragmentHostCallback mHost;

    final class LoaderInfo implements Loader.OnLoadCompleteListener