Android数据绑定框架DataBinding用法

    【尊重原创，转载请注明出处】http://blog.csdn.net/guyuealian/article/details/51953749

一、数据绑定框架DataBinding介绍：

     Android的新框架DataBinding给我们带来了很大的方便，以前可能需要在每个Activity里写很多的findViewById，不仅麻烦，还增加了代码的耦合性；而使用DataBinding，就可以抛弃findViewById。Data Binding 解决了 Android UI 编程中的一个痛点，官方原生支持 MVVM 模型可以让我们在不改变既有代码框架的前提下，非常容易地使用这些新特性。其实在此之前，已经有些第三方的框架（RoboAndroid) 可以支持 MVVM 模型，无耐由于框架的侵入性太强，导致一直没有流行起来。说到这里，其实网上也有很多快速的注解框架，但是注解框架与DataBinding想比还是不好用，而且官网文档说DataBinding还能提高解析XML的速度，其实DataBinding的好用，不仅仅体现在可以省去使用很多啰嗦findViewById，还有很多。
二、数据绑定框架DataBinding的用法：
（1）环境搭建：
   在使用DataBinding之前，首先要先学会搭建使用它的环境。鉴于是去年发布的，现在大家AS的版本估计都在1.5以上了，就在1.5的版本上搭建和介绍吧，1.5之前的大家可以在网上搜索，因为我看网上大多数是介绍的1.3的使用方法，还没有很多对于1.5之后的环境搭建方法。

Android 的 Gradle 插件版本不低于 1.5.0-alpha1：
classpath 'com.android.tools.build:gradle:1.5.0'
然后在对应模块（Module）的 build.grade中添加：

android {    ....    dataBinding {        enabled = true    }}

（2）例子展示

    例子的源代码【下载】←点击下载

    我们先用一个简单的例子来学习一下DataBinding的基础：

     1）首先先建立一个java bean，就是一个非常简单的Person 类。

package com.example.administrator.myapplication;/** * Created by Administrator on 2016/7/19. */public class Person {    private String name;    private String age;    public Person(String name, String age) {        this.age = age;        this.name = name;    }    public void setName(String name) {        this.name = name;    }    public void setAge(String age) {        this.age = age;    }    public String getName() {        return name;    }    public String getAge() {        return age;    }}

      2）再来看看使用了DataBinding之后的布局文件，其主要的变化是在layout布局文件之中。

<?xml version="1.0" encoding="utf-8"?><layout xmlns:android="http://schemas.android.com/apk/res/android">    <data>        <variable            name="per1"            type="com.example.administrator.myapplication.Person" />        <variable            name="work"            type="String" />    </data>    <LinearLayout        android:layout_width="match_parent"        android:layout_height="match_parent"        android:orientation="vertical">        <LinearLayout            android:layout_width="match_parent"            android:layout_height="wrap_content"            android:orientation="vertical">            <TextView                android:layout_width="wrap_content"                android:layout_height="wrap_content"                android:text="@{per1.name}" />            <TextView                android:layout_width="wrap_content"                android:layout_height="wrap_content"                android:text="@{String.valueOf(per1.age)}" />            <TextView                android:layout_width="wrap_content"                android:layout_height="wrap_content"                android:text="@{work}" />        </LinearLayout>    </LinearLayout></layout>

布局文件中并没有给控件定义id，而是用了@{ }的方法。Android studio是如何把值传进去的呢？在Activity中是又是如何使用的呢？

     3）MainActivity .java文件

package com.example.administrator.myapplication;import android.app.Activity;import android.databinding.DataBindingUtil;import android.os.Bundle;import com.example.administrator.myapplication.databinding.ActivityMainBinding;public class MainActivity extends Activity {    @Override    protected void onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);        // setContentView(R.layout.activity_main);        ActivityMainBinding binding = DataBindingUtil.setContentView(this, R.layout.activity_main);        Person per = new Person("zhang san", 40);        binding.setPer1(per);//给布局文件name="per1"传入数据,类型为Person对象        binding.setWork("Teacher");//给布局文件name="work"传入数据，类型为String字符串    }}

     MainActivity 中没有使用findViewById去指定需要初始化的控件，也没有使用setText()指定显示的内容。下面详细说明一下：

     1）使用DataBinding新框架必须导入包：import android.databinding.DataBindingUtil;

     2）以前在onCreate方法中通过setContentView设置布局；现在使用DataBindingUtil类的一个静态方法setContentView设置布局文件，但该方法会返回一个ActivityMainBinding对象。注意ActivityMainBinding对象会根据你的XML布局文件自动生成，其命名规则是这样的：先将XML布局文件的首字母大写；然后去掉下划线，将下划线后面的第一字母大写；再加Binding组合而成。如布局文件是activity_main，则对应的类名为：ActivityMainBinding

     3）ActivityMainBinding由编译器根据布局文件的名字自动生成，因此在使用ActivityMainBinding时需要导入该包，一般形式是：当前包名+databinding+ActivityMainBinding

import com.example.administrator.myapplication.databinding.ActivityMainBinding;

      运行结果效果图如下：

（3）DataBinding使用说明

     1）XML布局文件

      相比以前使用的xml，根节点由具体的某个layout（比如LinearLayout ）变成了layout，里面包括了data节点和传统的视图。先分析data节点，实质上这里的data节点就是连接 View 和 Modle 的桥梁。在这个data节点中声明一个variable变量，该变量需要指定name属性和type属性值。

<?xml version="1.0" encoding="utf-8"?><layout xmlns:android="http://schemas.android.com/apk/res/android">    <data>        <variable            name="per1"            type="com.example.administrator.myapplication.Person" />        <variable            name="work"            type="String" />    </data>    <LinearLayout        <LinearLayout……………………        </LinearLayout>    </LinearLayout></layout>

   变量名： name="per1"
    变量类型：type="com.example.administrator.myapplication.Person"
    type中声明的就是我们的用户实体类Person，等于全限定名（包+类名），我们给这个实体类命名为per1，per1可以看作是一个Person的对象。TextView中的@{per1.name}就是把这个per1中的名字展示出来，age同样如此。

     变量名：name="work"
     变量类型： type="String"

     那么控件是如何获得显示内容的呢？

      <TextView                android:layout_width="wrap_content"                android:layout_height="wrap_content"                android:text="@{per1.name}" />       <TextView                android:layout_width="wrap_content"                android:layout_height="wrap_content"                android:text="@{String.valueOf(per1.age)}" />       <TextView                android:layout_width="wrap_content"                android:layout_height="wrap_content"                android:text="@{work}" />

      注意到TextView的android:text，它的值是一个以@开始，以{}包裹的形式出现，而其内容由per1.name指定。per1就是我们上面定义的variable变量；而name是我们Person类中的一个变量。但name是Person的私有变量啊！！！！其实这里per1.name实质上调用的是Person类的getName()方法，因此per1.name等价于per1.getName()。 因此android:text="@{per1.name}"也可改为android:text="@{per1.getName()}"；对于其他控件的分析也如此。

     PS：android:text指定的内容为String类型，因此，per1.age是int类型需要转换为String类型。

    2）绑定Variable
     虽然在布局文件中对应上了，但是值是怎么传进去的呢？这就是我们要将的Activity中的那两行代码了，它把实体类和布局文件进行了绑定。修改MainActivity中的onCreate，用 DatabindingUtil.setContentView() 来替换掉 setContentView()，然后创建一个Person对象per ，通过 binding.setPer1(per)与 variable 进行绑定。

      由于在XML文件中，指定 name="per1"的类型为Person，因此setPer1(Person per)，即传入的类型必须是Person对象；同理在name="work"的类型为String，setWork("Teacher")必须传入字符串类型。

 protected void onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);        ActivityMainBinding binding = DataBindingUtil.setContentView(this, R.layout.activity_main);        Person per = new Person("zhang san", 40);        binding.setPer1(per);//给布局文件name="per1"传入数据,类型为Person对象        binding.setWork("Teacher");//给布局文件name="work"传入数据，类型为String字符串    }

 【注意事项】

     【1】 这里需要注意的是使用binding调用setXxx方法，其中Xxx对应XML布局文件 name="Xxx"或者name="xxx"；注意XML文件中name属性值的首字母可大写，也可小写。若 name="Xxx"，则 binding.setXxx()，若 name="xxx"，也是 binding.setXxx()，但不能写为 binding.setxxx()。

     【2】注意TextView控件设置显示文字时，若写为：android:text="@{per1.age}"，则会出现错误

String resource ID #0x28
at android.content.res.Resources.getText(Resources.java:244)

at android.widget.TextView.setText(TextView.java:3888)
at com.example.administrator.myapplication.databinding.ActivityMa……

      这是由于android:text只能接受字符串的属性值，因此需要转换一下类型：android:text="@{String.valueOf(per1.age)}"

     【3】如果出现以下错误，（1）可能是因为你没有指定资源类型，（2）更大的可能是因为你没有搭配dataBinding环境！

Error:(27, 31) No resource type specified (at 'text' with value '@{per1.name.toString()}').
Error:(32, 31) No resource type specified (at 'text' with value '@{String.valueOf(per1.age)}').
Error:(36, 31) No resource type specified (at 'text' with value '@{work}').

 

 【参考资料】

 关于DataBinding的高级应用，可以参考这些文章：

【1】《Android数据绑定框架DataBinding，堪称解决界面逻辑的黑科技》 http://www.jianshu.com/p/2d3227d9707d

【2】《 Android官方数据绑定框架DataBinding(一) 》http://blog.csdn.net/qibin0506/article/details/47393725

【3】《Android官方数据绑定框架DataBinding(二)》http://blog.csdn.net/qibin0506/article/details/47720125

【4】英文好的，推荐官网教程：https://developer.android.com/topic/libraries/data-binding/index.html