Android 官方数据绑定框架 Data Binding 简单使用

参考资料

https://developer.android.com/topic/libraries/data-binding/index.html

配置 Data Binding 环境

在需要使用 Data Binding 的 module 里加上如下配置：

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

若 module 所依赖的包使用了 Data Binding，module 里也仍然需要加上。
设置好之后，需要使用 gradle 同步项目，使项目加载依赖包。

从绑定对象里获取数据的几种方式

• 直接获取 public 修饰的变量的值，如下面的firstName
• 从属性的 getter 方法获取，如下面的lastName
• 直接以字段名为名字的方法获取，如下面的nativePlace

模拟一个 User 对象

首先要有对象来提供绑定才行，所以这里先建好一个用于测试的User类。

其中有 3 个字段，用于测试上面描述的获取数据的几种方式是否有效。

package com.zjq.databindingpractice;

/**
 * 模拟用户对象
 * Created by softwater on 2017/4/19.
 * Modified by softwater on 2017/4/19.
 */

public class User {
  /**
   * 姓，不提供 getter、setter 方法
   */
  public String firstName;
  /**
   * 名，提供标准的 getter、setter 方法
   */
  private String lastName;
  /**
   * 籍贯，提供标准的 setter 方法，getter 方法为 {@link #nativePlace()}
   */
  private String nativePlace;

  public void setLastName(String lastName) {
    this.lastName = lastName;
  }

  public String getLastName() {
    return this.lastName;
  }

  public void setNativePlace(String nativePlace) {
    this.nativePlace = nativePlace;
  }

  public String nativePlace() {
    return nativePlace;
  }
}

修改布局文件

使用 Data Binding 的布局文件有一点不同，就是最外层的标签是<layout>，不再是以前的各种ViewGroup。<layout>标签里使用<data>标签来指定界面绑定的数据对象。格式如下：

<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android">
  <data>
    <variable
        name="user"
        type="com.zjq.databindingpractice.User"
        />
  </data>
  <LinearLayout
      android:orientation="vertical"
      android:layout_width="match_parent"
      android:layout_height="match_parent"
      >
    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="@{user.firstName}"
        />
    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="@{user.lastName}"
        />
    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="@{user.nativePlace}"
        />
  </LinearLayout>
</layout>

其中

<data>
<variable name="user"
    type="com.zjq.databindingpractice.User"/>
</data>

这样就将com.zjq.databindingpractice.User对象绑定到了当前界面之中，并设置 name 属性为 user。
之后就可以使用@{}语法直接获取值设置到对应的 View 中。

此时绑定到界面的具体对象是不确定的，因为对象都还没有实例化，都还没有为 User 赋值，所以需要在代码里创建对象，并赋值，然后传递给界面。

在 Activity 里创建User对象并绑定到视图

@Override protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    //setContentView(R.layout.activity_main);
    ActivityMainBinding binding = DataBindingUtil.setContentView(this, R.layout.activity_main);

    User user = new User();
    user.firstName = "王";
    user.setLastName("菲菲");
    user.setLastName("背景");
    binding.setUser(user);
  }

上面的代码是在 Activity 里加载的，若界面使用了 Data Binding，就不能使用以前的setContentView()方法了，而要使用DataBindingUtil.setContentView(this, R.layout.activity_main);，这里的返回值是ActivityMainBinding，这个类是根据 layout 的文件名来的，就在 layout 文件名后面加上 Binding。如果编辑器提示找不到ActivityMainBinding类，请 sync 一下代码，或者 build 一次。
有了 User对象之后，需要使用binding.setUser(user);方法设置进去。

运行查看效果