Loader 知识梳理(2) - initLoader和restartLoader的区别

一、概述

在前面的一篇文章中,我们分析了LoaderManager的实现,里面涉及到了很多的细节问题,我们并不需要刻意地记住每个流程,之所以需要分析,以后在使用的过程中,如果遇到问题了,再去查看相关的源代码就好了。
对于Loader框架的理解,我认为掌握以下四个方面的东西就可以了:

  • LoaderManager的实现原理有一个大概的印象。
  • LoaderManager的三个关键方法initLoader/restartLoader/destroyLoader的使用场景。
  • 学会自定义Loader来实现数据的异步加载。
  • 总结一些App开发中常用的场景。

第一点可以参考前面的这篇文章:

Loader框架 - LoaderManager初探

今天这篇,我们将专注于分析第二点:initLoader/restartLoader的区别

二、基本概念的区别

首先,我们回顾一下,对于init/restart的定义:

  • initLoader

  • 通过调用这个方法来初始化一个特定IDLoader,如果当前已经有一个和这个ID关联的Loader,那么并不会去回调onCreateLoader来通知使用者传入一个新的 Loader实例替代那个旧的实例,仅仅是替代Callback,也就是说,上面的Bundle参数被丢弃了;而假如不存在一个关联的实例,那么会进行初始化,并启动它。

  • 这个方法通常是在Activity/Fragment的初始化阶段调用,因为它会判断之前是否存在相同的Loader,这样我们就可以复用之前已经加载过的数据,当屏幕装转导致Activity重建的时候,我们就不需要再去重新创建一个新的Loader,也免去了重新读取数据的过程。

  • restartLoader

  • 调用这个方法,将会重新创建一个指定IDLoader,如果当前已经有一个和这个ID关联的Loader,那么会对它进行canceled/stopped/destroyed等操作,之后,使用新传入的Bundle参数来创建一个新的Loader,并在数据加载完毕后递交给调用者。

  • 并且,在调用完这个函数之后,所有之前和这个ID关联的Loader都会失效,我们将不会收到它们传递过来的任何数据。

总结下来就是:

  • 当调用上面这两个方法时,如果不存在一个和ID关联的Loader,那么这两个方法是完全相同的。
  • 如果已经存在相关联的Loader,那么init方法除了替代Callback,不会做任何其它的事情,包括取消/停止等。而restart方法将会创建一个新的Loader,并且重新开始查询。

三、代码的区别

为了方便大家更直观地理解,我们截取一部分的源码来看一下:

  • initLoader
LoaderInfo info = mLoaders.get(id);
if (info == null) {
    //如果不存在关联的Loader,那么创建一个新的Loader
    info = createAndInstallLoader(id, args, LoaderManager.LoaderCallbacks)callback);
} else {
   //如果已经存在,那么仅仅替代Callback,传入的Bundle参数会被丢弃。
   info.mCallbacks = (LoaderManager.LoaderCallbacks)callback;
}
 
 
  • restartLoader
LoaderInfo info = mLoaders.get(id);
//如果已经存在一个相关联的Loader,那么执行操作。
if (info != null) {
    //mInactiveLoaders列表就是用来跟踪那些已经被抛弃的Loader
    LoaderInfo inactive = mInactiveLoaders.get(id);
    if (inactive != null) {
        //对跟踪列表进行一系列的操作。
    } else {
        //取消被抛弃的Loader,并加入到跟踪列表当中,以便在新的Loader完成任务之后销毁它。
        info.mLoader.abandon();
        mInactiveLoaders.put(id, info);
    }
}
//通知调用者,创建一个新的Loader,这个Loader将会和新的Bundle和Callback相关联。
info = createAndInstallLoader(id, args,  (LoaderManager.LoaderCallbacks)callback);
 
 

通过上面的代码,就印证了前面第二节我们的说话,我们根据这些区别可以知道它们各自的职责:

  • initLoader是用来确保Loader能够被初始化,如果已经存在相同IDLoader,那么它会复用之前的。
  • restartLoader的应用场景则是我们的查询条件发生了改变。因为LoaderManager是用ID关联的,当这个Loader已经获取到了数据,那么就不需要再启动它了。因此当我们的需求发生了改变,就需要重新创建一个Loader

也就是说:

  • 查询条件一直不变时,使用initLoader
  • 查询条件有可能发生改变时,采用restartLoader

五、对于屏幕旋转的情况

5.1 重建

当我们在Manifest.xml没有给Activity配置configChanged的时候,旋转屏幕会导致的Activity/Fragment重建,这时候有两点需要注意的:

  • 由于此时我们的查询条件并不会发生改变,并且LoaderManager会帮我们恢复Loader的状态。因此,我们没有必要再去调用restartLoader来重新创建Loader来执行一次耗时的查询操作。

  • LoaderManager虽然会恢复Loader,但是它不会保存Callback实例,因此,如果我们希望在旋转完之后获得数据,那么至少要调用一次initLoader来传入一个新的Callback进行监听。

在这种情况下,假如我们在旋转之前Loader已经加载数据完毕了,那么onLoadFinished会立即被会调

5.2 没有重建

当没有重建时,不会走onCreate方法,因此需要在别的地方来初始化Loader

5.3 LoaderId

针对上面的这两种情况,我们都需要自己去保存LoaderId,在组件恢复之后,通过这个保存的id去调用init/restart方法,一般情况下,是通过savedInstanceState来保存的。

六、示例

现在,我们通过一个很简单的例子,来看一下,initLoader/restartLoader的区别,我们的Demo中有一个EditText和一个TextView,当EditText发生改变时,我们将当前EditText的内容作为查询的Key,查询任务就是调用Loader,延时2s,并将这个key作为查询的结果展示在TextView上。

6.1 采用initLoader来查询:

public class MainActivity extends Activity {

    private static final String LOADER_TAG = "loader_tag";
    private static final String QUERY = "query";

    private MyLoaderCallback mMyLoaderCallback;
    private TextView mResultView;
    private EditText mEditText;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        init();
    }

    private void init() {
        mEditText = (EditText) findViewById(R.id.loader_input);
        mResultView = (TextView) findViewById(R.id.loader_result);
        mEditText.addTextChangedListener(new MyEditTextWatcher());
        mMyLoaderCallback = new MyLoaderCallback();
    }

    private void startQuery(String query) {
        if (query != null) {
            Bundle bundle = new Bundle();
            bundle.putString(QUERY, query);
            getLoaderManager().initLoader(0, bundle, mMyLoaderCallback);
        }
    }

    private void showResult(String result) {
        if (mResultView != null) {
            mResultView.setText(result);
        }
    }

    private static class MyLoader extends BaseDataLoader {

        public MyLoader(Context context, Bundle bundle) {
            super(context, bundle);
        }

        @Override
        protected String loadData(Bundle bundle) {
            Log.d(LOADER_TAG, "loadData");
            try {
                Thread.sleep(2000);
            } catch (Exception e) {
                e.printStackTrace();
            }
            return bundle != null ? bundle.getString(QUERY) : "empty";
        }
    }

    private class MyLoaderCallback implements LoaderManager.LoaderCallbacks {

        @Override
        public Loader onCreateLoader(int id, Bundle args) {
            Log.d(LOADER_TAG, "onCreateLoader");
            return new MyLoader(getApplicationContext(), args);
        }

        @Override
        public void onLoadFinished(Loader loader, Object data) {
            Log.d(LOADER_TAG, "onLoadFinished");
            showResult((String) data);
        }

        @Override
        public void onLoaderReset(Loader loader) {
            Log.d(LOADER_TAG, "onLoaderReset");
            showResult("");
        }
    }

    private class MyEditTextWatcher implements TextWatcher {

        @Override
        public void beforeTextChanged(CharSequence s, int start, int count, int after) {}

        @Override
        public void onTextChanged(CharSequence s, int start, int before, int count) {
            Log.d(LOADER_TAG, "onTextChanged=" + s);
            startQuery(s != null ? s.toString() : "");
        }

        @Override
        public void afterTextChanged(Editable s) {}
    }

}

当我们输入a时,成功地获取到了数据:

Loader 知识梳理(2) - initLoader和restartLoader的区别_第1张图片

之后,我们继续输入 b,发现 onLoadFinished立即被回调了,但是结果还是之前地 a

我们通过 AS的断电发现,整个调用过程如下:
Loader 知识梳理(2) - initLoader和restartLoader的区别_第2张图片

也就是在 initLoader之后,立即执行了:

    public  Loader initLoader(int id, Bundle args, LoaderManager.LoaderCallbacks callback) {
        //按照前面的分析,此时的info不为null。
        if (info.mHaveData && mStarted) {
            info.callOnLoadFinished(info.mLoader, info.mData);
        }
        return (Loader)info.mLoader;
    }

而之后,callOnLoadFinished就会把之前的数据传回给调用者,因此没有执行onCreateLoader,也没有进行查询操作:

        void callOnLoadFinished(Loader loader, Object data) {
            //传递数据给调用者.
            if (mCallbacks != null) {
                mCallbacks.onLoadFinished(loader, data);
            }
        }
 
 

假如,我们在a触发的任务还没有执行时就输入b,我们看看会发生什么,可以看到,它并不会考虑后来的任务:

Loader 知识梳理(2) - initLoader和restartLoader的区别_第3张图片

6.2 采用restartLoader查询

还是按照前面的方式,我们先输入a

Loader 知识梳理(2) - initLoader和restartLoader的区别_第4张图片

这时候,和采用 initLoader的结果完全相同,接下来再输入 b
Loader 知识梳理(2) - initLoader和restartLoader的区别_第5张图片

可以清楚地看到,在执行完 restartLoader之后, LoaderManager回调了 onCreateLoader方法让我们传入新的 Loader,并且之后重新进行了查询,并成功地返回了结果。
接下来,我们看一下连续输入的情况:
Loader 知识梳理(2) - initLoader和restartLoader的区别_第6张图片

可以看到,虽然 a触发的任务已经开始了,但是当我们输入 b的时候,最终得到的时 ab这个结果,并且 a所触发的任务的结果并没有返回给调用者,这也是我们所希望的,因为我们的结果一定是要以用户最后输入的为准。

6.3 加上保证正确初始化的代码

最后,我们再加上保证Loader能够正确初始化的代码,一个简单的联想输入 - 加载框架就搭建好了。

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        init();
        restore(savedInstanceState);
    }
    
    private void save(Bundle outState) {
        if (mEditText != null) {
            outState.putString(QUERY, mEditText.getText().toString());
        }
    }
    
    private void restore(Bundle savedInstanceState) {
        if (savedInstanceState != null) {
            Bundle bundle = new Bundle();
            String query = bundle.getString(QUERY);
            bundle.putString(QUERY, query);
            getLoaderManager().initLoader(0, bundle, mMyLoaderCallback);
        }
    }

    @Override
    protected void onSaveInstanceState(Bundle outState) {
        save(outState);
        super.onSaveInstanceState(outState);
    }

你可能感兴趣的:(Loader 知识梳理(2) - initLoader和restartLoader的区别)