Databinding与LiveData的合作

背景

在谷歌官方的最新框架中我们可以学到的一个新组件就是LiveData,能够监听生命周期的变化并且在适当的生命周期中回调方法,有效的解决了之前需要处理回调中View消失的问题。在使用层面上利用LiveData能够消除掉之前MVP中关于View的生命周期控制等类似的问题。

但是在使用的过程中,会发现一个弊端就是当你使用LiveData控制的数据,需要展示到界面上时,你需要将一个LiveData数据变成Observable类型的数据,然后通过Databinding进行绑定。虽然他们是内容是相同的,但是仍需要做一层转化。

这里说一下各自的优点,简单的概括一下:

  • LiveData:与生命周期关联,能够实现在特定的生命周期中进行回调。
  • Observable:能够与UI进行双向绑定。

从最开始使用LiveData时,就在思考一个问题,有没有方法能够消除掉这一层的转化,或者说有没有一种新的数据类型,既能与生命周期关联,又能与UI进行双向绑定。惭愧的说尝试一番,无果。在学习LiveData的过程中,在官方的issue中看到作者正在着手解决这个痛点,不过一直都没有最新的消息。直到这个新年的第一个工作日。

最新进展

新年第一天上班,打开电脑,习惯性的把日常的Android站点都逛一遍,就发现了一篇新的文章介绍说官方已经在最新的Androdi Studio 3.1 canary6预览版中加入了LiveDataDatabinding的处理,不用再进行转换才能响应到UI上了,文章还给了一个小的例子。那个文章的地址会放在为文末,还有对应的github地址。看到这个,我马上就尝试了一下,下面就都是流水账了。

下载最新预览版Studio

预览版地址
安装和创建一个普通的项目这里都不说了。然后就是添加依赖:

dependencies {
    ...
    implementation 'android.arch.lifecycle:extensions:1.0.0'
    annotationProcessor 'android.arch.lifecycle:compiler:1.0.0'
    ...
}

这里就引用最基本的一个extension就可以了。在添加这两个依赖的时候操作起来特别的卡,不知道是我电脑的问题还是最新的这个Studio的问题。

写个小例子

这里我创建了一个MainViewModel,用于测试,直接上代码,基本都没有难度:

public class MainViewModel extends ViewModel {

    public final MutableLiveData<String> input = new MutableLiveData<>();
    public final MutableLiveData<String> include_string = new MutableLiveData<>();
    Handler handler;

    public MainViewModel() {
        input.setValue("test");
        include_string.setValue("include_string");
        handler = new Handler();
    }

    public void onClick() {
        Random random = new Random();
        input.setValue(random.nextInt(100) + "");
        include_string.setValue(random.nextInt(100) + "");
    }

    public void onAsyncClick() {
        final Random random = new Random();

        handler.postDelayed(new Runnable() {
            @Override
            public void run() {
                input.setValue(random.nextInt(100) + "async");
                include_string.setValue(random.nextInt(100) + "async");
            }
        }, 5000);
    }
    
}

这里有两个string,分别对应两个EditText,一个是正常界面里的,一个是include进来的。两个点击事件,一个是正常的,一个是异步的。

看一下MainActivity:

public class MainActivity extends AppCompatActivity {
    ActivityMainBinding mBinding;
    MainViewModel mainViewModel;
    String TAG = "TAG";

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        mBinding = DataBindingUtil.setContentView(this, R.layout.activity_main);
        mainViewModel = ViewModelProviders.of(this, new ViewModelProvider.NewInstanceFactory()).get(MainViewModel.class);
        mBinding.setViewModel(mainViewModel);
        mBinding.setLifecycleOwner(this);
        mBinding.input.addTextChangedListener(new TextWatcher() {
            @Override
            public void beforeTextChanged(CharSequence s, int start, int count, int after) {
                Log.d(TAG, "beforeTextChanged: ");
            }

            @Override
            public void onTextChanged(CharSequence s, int start, int before, int count) {
                Log.d(TAG, "onTextChanged: ");
            }

            @Override
            public void afterTextChanged(Editable s) {
                if (s != null) {
                    Log.d("TAG", "afterTextChanged: " + s.toString());
                } else {
                    Log.d("TAG", "afterTextChanged: " + "null");
                }
                Log.d(TAG, "afterTextChanged: " + mainViewModel.input.getValue());
            }
        });
        mBinding.includeView.setLifecycleOwner(this);
        mBinding.includeView.setViewModel(mainViewModel);
    }
}

先是绑定下布局,然后创建个MainViewModel,之后就是将ViewModel绑定到View上,然后就是新的API了, 也是最为重要的方法,给当前的Databinding添加生命周期的拥有者,然后我给当前界面的EditText添加了一个监听。关于include的一会再聊,跑一下之后,你就会发现项目正常运行,并且当MainViewModel中数据改变,UI也会跟着改变。

这里需要给之前不是特别熟悉LiveDataDatabinding的小伙伴们说一下,通常情况下,Databinding能够通知到Ui的数据,必须得是继承自BaseObsevable的。但是上面的例子中并没有,那么是如果进行通知的那?

原始后代码解读

先从setLifecycleOwner()开始:

 @MainThread
    public void setLifecycleOwner(@Nullable LifecycleOwner lifecycleOwner) {
         //先判断当前mLifecycleOwner相同,相同返回
        if (mLifecycleOwner == lifecycleOwner) {
            return;
        }
        //当前有,但是不一致的话先将先前的LifecycleObserver移除
        if (mLifecycleOwner != null) {
            mLifecycleOwner.getLifecycle().removeObserver(mOnStartListener);
        }
        //赋新值
        mLifecycleOwner = lifecycleOwner;
        if (lifecycleOwner != null) {
            //重新添加LifecycleObserver,如果之前有就添加之前的,没有就新创建一个。
            if (mOnStartListener == null) {
                mOnStartListener = new OnStartListener();
            }
            lifecycleOwner.getLifecycle().addObserver(mOnStartListener);
        }
        //将所有的注册的UI变化需要响应监听对象都设置当前的lifecycleOwner。
        for (WeakListener<?> weakListener : mLocalFieldObservers) {
            if (weakListener != null) {
                weakListener.setLifecycleOwner(lifecycleOwner);
            }
        }
    }

个人对Databinding不是特别熟悉,不过这个方法的主要目的还是给当前的lifecycleOwner,添加一个生命周期的观察者,然后将所有的需要进行响应的都注册到这个lifecycleOwner上。看一下OnStartListener 这个监听。

 public class OnStartListener implements LifecycleObserver {
        private OnStartListener() {
        }

        @OnLifecycleEvent(Lifecycle.Event.ON_START)
        public void onStart() {
            executePendingBindings();
        }
    }

可以看到只有一个ON_START的生命周期事件,当上面的lifecycleOwnerON_START的时候会调用到executePendingBindings()方法;

这里原始代码层面的就没有了,新添加了一个方法,用于设置当前的生命周期持有者,然后给这个持有者添加一个只接收ON_START事件的生命周期观察者,当生命周期可用的时候刷新当前页面的数据。

编译后代码解读

在上面的例子中使用LiveData通知到View上有两种情况:

  1. 在当前的View是可用的情况下,更新数据,直接修改UI。
  2. 在当前的View是不可用的情况下,更新数据,等待View是可用的,然后修改UI。

第二种情况中判断Ui是否是可用的,然后调用刷新数据的就是上文的OnStartListener

针对第一种情况,思考一下,是如何做到的当LiveData数据修改的时候,能够通知DataBinding 刷新对应的UI的呢?

这里先看一个DataBinding的核心函数:

   @Override
    protected void executeBindings() {
        long dirtyFlags = 0;
        synchronized(this) {
            dirtyFlags = mDirtyFlags;
            mDirtyFlags = 0;
        }
        java.lang.String viewModelInputGetValue = null;
        android.arch.lifecycle.MutableLiveData<java.lang.String> viewModelInput = null;
        com.example.huangbaole.databindinglivedata.MainViewModel viewModel = mViewModel;

        if ((dirtyFlags & 0xdL) != 0) {



                if (viewModel != null) {
                    // read viewModel.input
                    viewModelInput = viewModel.input;
                }
                //*******
                updateLiveDataRegistration(0, viewModelInput);


                if (viewModelInput != null) {
                    // read viewModel.input.getValue()
                    viewModelInputGetValue = viewModelInput.getValue();
                }
        }
        // batch finished
        if ((dirtyFlags & 0xcL) != 0) {
            // api target 1

            this.includeView.setViewModel(viewModel);
        }
        if ((dirtyFlags & 0xdL) != 0) {
            // api target 1

            android.databinding.adapters.TextViewBindingAdapter.setText(this.input, viewModelInputGetValue);
        }
        if ((dirtyFlags & 0x8L) != 0) {
            // api target 1

            android.databinding.adapters.TextViewBindingAdapter.setTextWatcher(this.input, (android.databinding.adapters.TextViewBindingAdapter.BeforeTextChanged)null, (android.databinding.adapters.TextViewBindingAdapter.OnTextChanged)null, (android.databinding.adapters.TextViewBindingAdapter.AfterTextChanged)null, inputandroidTextAttrChanged);
            this.mboundView2.setOnClickListener(mCallback1);
            this.mboundView3.setOnClickListener(mCallback2);
        }
        executeBindingsOn(includeView);
    }

有了解过DataBinding编译后代码的小伙伴们都应该熟悉这个函数,与之前有些不同的是,当你在XML中绑定的数据是LiveData类型的时候,它对应的UpDate方法是updateLiveDataRegistration(),看一下这个方法都做了什么?

 protected boolean updateLiveDataRegistration(int localFieldId, LiveData<?> observable) {
        return updateRegistration(localFieldId, observable, CREATE_LIVE_DATA_LISTENER);
    }

内部调用了updateRegistration()方法,这个方式是所有的能够通知到UI的数据类型都会调用的(目前有Observable,ObservableList,ObservableMap,LiveData),这里的主要区别是CreateWeakListener,不同的类型对应的生成弱引用监听者的类型不一致。这里使用的是CREATE_LIVE_DATA_LISTENER会创建一个LiveDataListener然后获取持有的弱引用返回。

    private boolean updateRegistration(int localFieldId, Object observable,
            CreateWeakListener listenerCreator) {
        if (observable == null) {
            return unregisterFrom(localFieldId);
        }
        WeakListener listener = mLocalFieldObservers[localFieldId];
        if (listener == null) {
            //如果当前的fieldID没有对应的监听的话,那么会调用注册的方法
            registerTo(localFieldId, observable, listenerCreator);
            return true;
        }
        if (listener.getTarget() == observable) {
            return false;//nothing to do, same object
        }
        unregisterFrom(localFieldId);
        registerTo(localFieldId, observable, listenerCreator);
        return true;
    }
    
      protected void registerTo(int localFieldId, Object observable,
            CreateWeakListener listenerCreator) {
        if (observable == null) {
            return;
        }
        WeakListener listener = mLocalFieldObservers[localFieldId];
        if (listener == null) {
            //使用listenerCreator创建一个当前与fieldId对应的Listener
            listener = listenerCreator.create(this, localFieldId);
            mLocalFieldObservers[localFieldId] = listener;
            if (mLifecycleOwner != null) {
                    //调用这个Listener的setLifecycleOwner方法。
                listener.setLifecycleOwner(mLifecycleOwner);
            }
        }
        listener.setTarget(observable);
    }

这里跟之前的旧版本基本是一直的,只是多了一个listener.setLifecycleOwner(mLifecycleOwner);方法,在之前的listener中是没有setLifecycleOwner这个方法的。并且也只有LiveDataListener需要这个方法,其他的都是空实现。这里估计后面会重新优化一下吧。

接下来就是重点了,也是LiveData能够通知UI更新的关键,LiveDataListener:

  private static class LiveDataListener implements Observer,
            ObservableReference<LiveData<?>> {
        final WeakListener<LiveData<?>> mListener;
        LifecycleOwner mLifecycleOwner;

        public LiveDataListener(ViewDataBinding binder, int localFieldId) {
            mListener = new WeakListener(binder, localFieldId, this);
        }

        @Override
        public void setLifecycleOwner(LifecycleOwner lifecycleOwner) {
            LifecycleOwner owner = (LifecycleOwner) lifecycleOwner;
            LiveData<?> liveData = mListener.getTarget();
            if (liveData != null) {
                if (mLifecycleOwner != null) {
                    liveData.removeObserver(this);
                }
                if (lifecycleOwner != null) {
                        //这里就是LiveDatag观察生命周期的地方。owner是之前的mLifecycleOwner,this则是对应的响应,这是是当前类本身,回调是onChanged()
                    liveData.observe(owner, this);
                }
            }
            mLifecycleOwner = owner;
        }

        @Override
        public WeakListener<LiveData<?>> getListener() {
            return mListener;
        }

        @Override
        public void addListener(LiveData<?> target) {
            if (mLifecycleOwner != null) {
                target.observe(mLifecycleOwner, this);
            }
        }

        @Override
        public void removeListener(LiveData<?> target) {
            target.removeObserver(this);
        }

        @Override
        public void onChanged(@Nullable Object o) {
                //这里是LiveData观察LifecycleOwner对应的响应,调用当前的fieldId刷新。
            ViewDataBinding binder = mListener.getBinder();
            binder.handleFieldChange(mListener.mLocalFieldId, mListener.getTarget(), 0);
        }
    }

目前就这么多吧,有一个整体的轮廓。简单总结一下

总结

当使用LiveData进行更新数据的时候,会创建一个LiveDataListener添加的当前binding的数组中
针对上文的两种更新数据的情况:

第一种:当LiveData更新的时候,会调用LiveDataListener中的onChange方法,然后binding会刷新对应FieldID的UI。

第二种:View从不可用到可用,调用onStart生命周期函数的时候,会调用onStartListener的onStart方法,会刷新所有的bind数据。同时由于当前的LiveDataListener中也将LifecycleOwner订阅到LiveData上了,所以,第一种方案应该也是会执行的,也就是说会出现重复赋值的情况(这里是猜测,目前没有进行验证)。

关于include的使用

这里说一下include中使用LiveData的影响,默认的情况下,我以为只需要绑定下ViewModel就可以,其实不是,这里需要给include的binding 也要设置LifecycleOwner。就如我上面例子写的那样,估计这里以后也可能会优化,毕竟include的View 应该会和当前的View拥有相同的LifecycleOwner吧。

收获

对DataBinding的原理应该是更熟悉了一些吧,然后LiveData的使用应该更加的灵活,而不仅仅的就是一个有用生命周期的数据,通过Lifecycle,我们能够实现任何和生命周期相关的东西,而不仅仅就是数据。作为新年你的第一篇文章,有点水,也有些仓促,有好几个关键的点,没有进行验证和测试,不过目前的版本不会是最终的版本,等有正式版的时候会重新写一篇正式一点的。

相关地址

国外文章

国外文章项目地址

本文的项目地址

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,324评论 5 476
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,303评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,192评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,555评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,569评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,566评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,927评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,583评论 0 257
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,827评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,590评论 2 320
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,669评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,365评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,941评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,928评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,159评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,880评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,399评论 2 342

推荐阅读更多精彩内容