Data Binding的基本使用

当第一次看到Data Binding的时候，我就深深的被它吸引了。

因为它可以让数据直接与xml布局绑定，不用再去写繁琐的初始化查找控件再去给其赋值，省去了重复代码的体力活，提高了我们开发的效率。

经过一番学习，现在把一些基本的使用方法分享出来，希望能帮助想要学习的小伙伴。

学习的前提是你的 android studio 版本要高于等于1.3.0 。在它以下AS是不支持的。不过1.3.0现在应该不会有什么人使用了吧。

先来说说配置，在你的模块的 build.gradle 文件中的 android 节点里添加 dataBinding 配置：

dataBinding {
    enabled = true
}

data binding 主要就是在xml布局里面的语法使用，在使用它的布局里面，起始根标签是layout，然后下来一个data元素以及一个view根元素，这个view元素就是原来没有使用 data binding 的布局里的根元素。

1.  activity_main布局。

<?xml version="1.0" encoding="utf-8"?>
<layout
    xmlns:android="http://schemas.android.com/apk/res/android">

    <data>

        <variable
            name="bean"
            type="com.example.weioule.databindingdemo.Bean"/>
    </data>

    <RelativeLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent">

        <TextView
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_marginLeft="25dp"
            android:layout_marginTop="25dp"
            android:text="@{bean.name}"
            android:textSize="15sp"/>

        <TextView
            android:id="@+id/btn"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_alignParentBottom="true"
            android:layout_alignParentRight="true"
            android:layout_marginBottom="25dp"
            android:layout_marginRight="25dp"
            android:padding="10dp"
            android:text="do next"/>
    </RelativeLayout>
</layout>

像上面的activity_main布局中，xmlns:android的命名空间你可以写在layout跟布局里也可以写在下面的View元素的跟布局里。

data元素里的variable标签就是我们所要绑定的数据，name可以自己定义，type就得指向你的Bean类了，用包名点类名的形式。

在data中可以有多个variable数据 ，其数据类型也可以是任意类型。

当我们在MainActivity里获取到data dinding对象把Bean的实例给设置进来时，这里的bean就有值了。设置的方法为你set拼接上你的name的名字首字母大写，类似我们所写的set方法，我们这里是setBean()。

定义好数据后，在下面就可以使用了，看我们的第一个TextView的文本设置，引用的就是我们的Bean数据里的name属性，它的写法为 @{bean.name} 。

来看看我们的MainActivity里是怎么与xml进行绑定的：

ActivityMainBinding binding = DataBindingUtil.setContentView(this, R.layout.activity_main);
binding.setBean(new Bean("垚鑫"));

原来的 setContentView() 替换成了 DataBindingUtil.setContentView()，填充布局后返回一个 ViewDataBinding 的子类对象 binding，它的类名是可以由你自己命名的，这里我们没有定义就使用默认的名字。

命名规则是，xml文件的名字去掉下划线，后面加上Binding，采用驼峰法命名。这里呢我们的就是 ActivityMainBinding 了。

这样绑定后布局里所有的控件的id都可以直接获取，不必再使用 findViewById ，就像MainActivity里的btn一样直接使用。

binding.btn.setOnClickListener(new View.OnClickListener() {
    ....
});

绑定后通过 binding 给xml里设置数据 binding.setBean(new Bean("垚鑫"));

一定要记得用 ActivityMainBinding 类型接收返回的对象，因为你自动补全的时候生成的类型是 ViewDataBinding 。你不用ActivityMainBinding 接收的话，它是找不到你的bean对应的设置数据方法的。

另外获取binding还有两种方法：

第二种方法 

ActivityMainBinding binding = ActivityMainBinding.inflate(getLayoutInflater());
View view = binding.getRoot();
setContentView(view);

第二种方法 

View view = getLayoutInflater().inflate(R.layout.activity_main, null);
ActivityMainBinding binding = ActivityMainBinding.bind(view);
setContentView(view);

2.  我们来看看布局 activity_second。

<?xml version="1.0" encoding="utf-8"?>
<layout
    xmlns:android="http://schemas.android.com/apk/res/android">

    <data class="SecondAvtivityBinding">

        <import type="android.view.View"/>

        <import
            alias="MyView"
            type="com.example.weioule.databindingdemo.View"/>

        <variable
            name="bean"
            type="com.example.weioule.databindingdemo.Bean"/>

    </data>

    <RelativeLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent">

        <TextView
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_marginLeft="25dp"
            android:layout_marginTop="25dp"
            android:text="@{bean.name}"
            android:textSize="15sp"
            android:visibility="@{bean.visible?View.VISIBLE:View.GONE}"/>

        <TextView
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_marginLeft="25dp"
            android:layout_marginTop="65dp"
            android:text="@{bean.title ?? `title为空`}"
            android:textSize="15sp"/>

        <TextView
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_marginLeft="25dp"
            android:layout_marginTop="105dp"
            android:text="@{MyView.txt+`\n\n`+MyView.fun}"
            android:textSize="15sp"/>

        <TextView
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_alignParentBottom="true"
            android:layout_alignParentRight="true"
            android:layout_marginBottom="25dp"
            android:layout_marginRight="25dp"
            android:onClick="doNext"
            android:padding="10dp"
            android:text="do next"/>
    </RelativeLayout>
</layout>

我们在上面说过，binding 对象的类名是可以自己定义的，布局 activity_second 中 data 标签里 class = "SecondActivityBinding" 就是我们自己定义的类名 SecondActivityBinding 。

这个类在编译时被自动生成并放置在module包里的databinding包下。

另外还有两种写法：

<data class=".SecondActivityBinding">
    
<data class="com.example.weioule.databindingdemo.SecondActivityBinding>

这两种写法会让这个类在编译时被自动生成直接放置在module包下。

import 标签是导入的意思，可以导入多个，类似我们在类中import，我们上面写的是导入Android的View组件。导入View组件之后我们在xml里就可以使用了，第一个TextView的visibility属性我们就用到了三元运算符，显示和隐藏直接调用View.VISIBLE和 View.GONE 。

当 import 的类名一样（有冲突）时，可以把其中一个类重命名，写法为： (alias= "xx")

<import type="android.view.View"/>
<import type="com.example.weioule.databindingdemo.View"  alias="MyView"/>

这样重命名区分之后就可以把 MyView 当 com.example.weioule.databindingdemo里的View当去使用了：text="@{MyView.txt}"

导入类后就可以在表达式中直接使用static属性和方法，类名点即可：android:text="@{ MyView.txt +`\n\n`+ MyView.fun }"。

第二个TextView的文本设置我们使用了null合并运算符： "@{bean.title ?? `title为空`}"

null合并运算符 与三元运算符有些相似，如果第一个操作数不是null 时，整个表达式就等于第一个操作数的值，反之整个表达式就等于第二个操作数的值。

`title为空` 的反引号是因为：字符串文本 在属性值两边使用单引号时，则表达式中使用双引号；也可以使用双引号来包围属性值， 这样的话，字符串文字则就要使用反引号；

3.  我们再来看看 activity_third 布局。

<?xml version="1.0" encoding="utf-8"?>
<layout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto">

    <data>

        <import type="java.util.List"/>

        <variable
            name="list"
            type="List&lt;String>"/>

        <variable
            name="bean"
            type="com.example.weioule.databindingdemo.Bean"/>
    </data>

    <RelativeLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent">

        <include
            android:id="@+id/include"
            layout="@layout/layout_include"
            app:bean="@{bean}"/>

        <TextView
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_below="@+id/include"
            android:layout_marginLeft="25dp"
            android:layout_marginTop="10dp"
            android:text="@{bean.name +` `+ @string/str}"/>

        <TextView
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_alignParentBottom="true"
            android:layout_alignParentRight="true"
            android:layout_marginBottom="25dp"
            android:layout_marginRight="25dp"
            android:padding="10dp"
            android:text="@{list[0]}"/>
    </RelativeLayout>
</layout>

data元素里声明了两个variable数据元素, 一个类型为String的List集合 list，一个是Bean的实例。

 type="List&lt;String>" 中的【 &lt; 】是转义字符用来替换【 < 】，原文是type="List<String>" 。 否则会报错编译不通过。

在使用 list 的的时候跟代码里一样，用 [ index ] 就可以了：text="@{ list[0] }"。

arrays、lists、sparse lists以及maps 等集合用法一致。

当 include 另一个布局的时候，将数据传过去 app:bean="@{bean}" 。这个 bean 属性一定要与所 include 的布局里 variable 标签的 name 要一致。否则找不到该属性就会报错。

第一个TextView的文本设置 text="@{bean.name +` `+ @string/str}"  是直接引用strings文件里定义的字符串str，因为data binding 在xml里是可以使用正常的表达式来访问 resources 资源的，包括 dimens 和 colors等。

4.  我们看看layout_include。

<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android">

    <data>

        <variable
            name="bean"
            type="com.example.weioule.databindingdemo.Bean"/>
    </data>

    <LinearLayout
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:orientation="vertical">

        <TextView
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_marginLeft="25dp"
            android:layout_marginTop="25dp"
            android:text="@{bean.title??`title为空`}"/>

        <TextView
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_marginLeft="25dp"
            android:layout_marginTop="10dp"
            android:text='@{bean.visible?"visible = true":"visible = flase"}'/>
    </LinearLayout>
</layout>

variable 标签定义的 name= "bean" ，是可以用属性的方式给它赋值的，就像上面的 app:bean="@{bean}" 。

第二个TextView的文本设置android:text='@{bean.visible?"visible = true":"visible = flase"}'  是两边用的单引号括起来，所以里面就可以用双引号来包文字。

ok，data binding的基本使用就到这里了。相信认真看完这篇文章，你也学会data binding的一些基础使用方法了。

demo项目地址：https://github.com/weioule/DataBindingDemo