DataBinding最详细使用

Google开源的数据绑定框架, 实现了MVVM架构, 增强了xml的功能, 大幅度精简了java代码量, 并且代码可读性更高, 对性能的影响基本为零.

DataBinding会自动在build目录下生成类. 因为被集成进AndroidStudio所以不需要你手动编译会实时编译, 并且支持大部分代码补全.

启用DataBinding

android{
      dataBinding {
        enabled = true;
    }
}

因为怕你们没注意到我写在文章开头

• 我想强调的是XML只做赋值或者简单的三元运算或者判空等不要做复杂运算;
• 逻辑运算在Model中
• 有时候可以偷懒将Activity当作ViewModel来使用

DataBinding的强大是毋庸置疑, 只会更方便(抛弃MVP吧);

鉴于文章篇幅, 后面我将会出一篇文章以及开源库告诉大家如何实现DataBinding是如何让RecyclerView一行代码写通用适配器(无需写实现类)

一行代码实现多类型/添加头布局脚布局/点击事件;

布局

布局文件

<layout>

    <data>
        <variable
            name="user"
            type="com.liangjingkanji.databinding.pojo.UserBean"/>
    data>

    <RelativeLayout
        xmlns:android="http://schemas.android.com/apk/res/android"
        xmlns:tools="http://schemas.android.com/tools"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        tools:context="com.liangjingkanji.databinding.MainActivity">

        <TextView
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="@{user.userName}"
            />

    RelativeLayout>

layout>

layout

布局根节点必须是 . 同时layout只能包含一个View标签. 不能直接包含

data

标签的内容即DataBinding的数据. data标签只能存在一个.

variable

通过标签可以指定类, 然后在控件的属性值中就可以使用

<data>
    <variable name="user" type="com.liangfeizc.databindingsamples.basic.User" />
data>

通过DataBinding的setxx()方法可以给Variable设置数据. name值不能包含_下划线

import

第二种写法(导入), 默认导入了java/lang包下的类(String/Integer). 可以直接使用被导入的类的静态方法.

<data>
  
    <import type="com.liangfeizc.databindingsamples.basic.User" />
  
    <variable name="user" type="User" />
data>

使用类

<TextView
          android:layout_width="wrap_content"
          android:layout_height="wrap_content"
          android:text="@{user.userName}"
          />

Tip: user代表UserBean这个类, 可以使用UserBean中的方法以及成员变量. 如果是getxx()会自动识别为xx. 注意不能使用字符串android, 否则会报错无法绑定.

class

标签有个属性可以自定义DataBinding生成的类名以及路径

<data class="CustomDataBinding">data>


<data class=".CustomDataBinding">data> 

Tip:注意没有代码自动补全. 自定义路径Module/build/generated/source/apt/debug/databinding/目录下, 基本上不需要自定义路径

默认:

public class MainActivity extends AppCompatActivity {

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

    // ActivityMainBinding这个类根据布局文件名生成(id+Binding)
    ActivityMainBinding viewDataBinding = DataBindingUtil.setContentView(this, R.layout.activity_main);

    UserBean userBean = new UserBean();
    userBean.setUserName("姜涛");

    // setUser这个方法根据Variable标签的name属性自动生成
    viewDataBinding.setUser(userBean);
  }
}

alias

标签如果需要导入(import)两个同名的类时可以使用alias属性(别名属性)

<import type="com.example.home.data.User" />
<import type="com.examle.detail.data.User" alias="DetailUser" />
<variable name="user" type="DetailUser" />

include

在include其他布局的时候可能需要传递变量(variable)值过去

<variable
          name="userName"
          type="String"/>

....

<include
         layout="@layout/include_demo"
         bind:userName="@{userName}"/>

include_demo

    <data>

        <variable
            name="userName"
            type="String"/>
    data>

...

android:text="@{userName}"

两个布局通过include的bind:<变量名>值来传递. 而且两者必须有同一个变量

DataBinding不支持merge标签

自动布局属性

DataBinding对于自定义属性支持非常好, 只要View中包含setter方法就可以直接在布局中使用该属性(这是因为DataBinding的库中官方已经帮你写好了很多自定义属性)

public void setCustomName(@NonNull final String customName) {
    mLastName.setText("吴彦祖");
  }

然后直接使用(但是IDE没有代码补全)

app:customName="@{@string/wuyanzu}"

但是setter方法只支持单个参数. app:这个命名空间可以随意

数据双向绑定

视图跟随数据刷新

BaseObservable

如果需要数据变化是视图也跟着变化则需要使用到以下两种方法

有两种方式:

1. 继承BaseObservable

   public class ObservableUser extends BaseObservable {
      private String firstName;
      private String lastName;
   
      @Bindable
      public String getFirstName() {
          return firstName;
      }
   
    // 注解才会自动在build目录BR类中生成entry, 要求方法名必须以get开头
      @Bindable
      public String getLastName() {
          return lastName;
      }
   
      public void setFirstName(String firstName) {
          this.firstName = firstName;
          notifyPropertyChanged(BR.firstName);
      }
   
      public void setLastName(String lastName) {
          this.lastName = lastName;
          notifyPropertyChanged(BR.lastName); // 需要手动刷新
      }
   }

还可以监听属性改变事件

ObservableUser.addOnPropertyChangedCallback(new Observable.OnPropertyChangedCallback() {
  @Override
  public void onPropertyChanged(Observable observable, int i) {

  }
});

属性第一次改变时会回调两次, 之后都只回调一次. 如果使用notifyChange()不会得到id(即i等于0). 使用

notifyPropertyChanged(i)就可以在回调里面得到id.

BaseObservable和Observable的区别:

1. BaseObservable是实现了Observable的类, 帮我们实现了监听器的线程安全问题.
2. BaseObservable使用了PropertyChangeRegistry来执行OnPropertyChangedCallback
3. 所以我不推荐你直接实现Observable.

ObservableField

databinding默认实现了一系列实现Observable接口的字段类型

BaseObservable,
ObservableBoolean,
ObservableByte,
ObservableChar,
ObservableDouble,
ObservableField,
ObservableFloat,
ObservableInt,
ObservableLong,
ObservableParcelable,
ObservableShort,
ViewDataBinding

示例

public class PlainUser {
  public final ObservableField firstName = new ObservableField<>();
  public final ObservableField lastName = new ObservableField<>();
  public final ObservableInt age = new ObservableInt();
}

对于集合数据类型ObservableArrayMap/ObservableArrayLis/ObjservableMap等集合数据类型

ObservableArrayMap user = new ObservableArrayMap<>();
user.put("firstName", "Google");
user.put("lastName", "Inc.");
user.put("age", 17);

使用

<data>
    <import type="android.databinding.ObservableMap"/>
    <variable name="user" type="ObservableMap"/>
data>
…
<TextView
   android:text='@{user["lastName"]}'
   android:layout_width="wrap_content"
   android:layout_height="wrap_content"/>
<TextView
   android:text='@{String.valueOf(1 + (Integer)user["age"])}'
   android:layout_width="wrap_content"
   android:layout_height="wrap_content"/>

Tip:

1. 还支持ObservableParcelable