Android DataBinding（三）单向绑定-BaseObservable

2021-11-19

单向绑定刷新 UI 有三种方式：BaseObservable、ObservableField、ObservableCollection。

BaseObservable
BaseObservable 提供了两个刷新 UI 的方法：notifyPropertyChanged、notifyChange。
方法说明
notifyPropertyChanged(int fieldId)	通知侦听器此实例的特定属性已更改
notifyChange()	通知监听器此实例的所有属性已更改

在局部 UI 的刷新过程中，notifyPropertyChanged() 需要传入一个 int 类型的参数，这个参数就是 fieldId，指的就是特定属性名对应的 ID。这里要注意的是，这个属性必须是 public 类型，并且被 @Bindable 注解进行修饰，否则会报错。本例中以 User 类的 name 属性进行局部 UI 刷新测试，代码如下：

package com.sunzn.bind;

import androidx.databinding.BaseObservable;
import androidx.databinding.Bindable;

import com.sunzn.data.BR;

public class User extends BaseObservable {

    private int id;

    @Bindable
    public String name;

    public User(int id, String name) {
        this.id = id;
        this.name = name;
    }

    public int getId() {
        return id;
    }

    public void setId(int id) {
        this.id = id;
        notifyChange();
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
        notifyPropertyChanged(BR.name);
    }

}

✦ 注意： BR 类在导包的时候需选择项目包名。

准备工作完成后，紧接着就可以设置点击事件，通过点击事件来变更实体的属性值，进而驱动 UI 的变更。这里需要注意的是点击事件的设置需要搭配布局文件来使用，代码如下：

package com.sunzn.data;

import android.os.Bundle;
import android.widget.Toast;

import androidx.appcompat.app.AppCompatActivity;
import androidx.databinding.DataBindingUtil;

import com.sunzn.bind.User;
import com.sunzn.data.databinding.ActivityMainBinding;

public class MainActivity extends AppCompatActivity {

    private User user;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        ActivityMainBinding binding = DataBindingUtil.setContentView(this, R.layout.activity_main);
        binding.setClickListener(new ClickListener());
        user = new User(1, "sunzn");
        binding.setUser(user);
    }

    public class ClickListener {
        public void onUserIDClick() {
            user.setId(8);
            Toast.makeText(MainActivity.this, "改变用户编码", Toast.LENGTH_SHORT).show();
        }

        public void onUserNameClick() {
            user.setName("vimeo");
            Toast.makeText(MainActivity.this, "改变用户姓名", Toast.LENGTH_SHORT).show();
        }
    }

}

布局文件需要将可观测的实体（User）、监听器（ClickListener）导入，并对 onClick 事件进行绑定。到此，就可以运行测试了。代码如下：

<?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="com.sunzn.bind.User" />

        <import type="com.sunzn.data.MainActivity.ClickListener" />

        <variable
            name="user"
            type="User" />

        <variable
            name="clickListener"
            type="ClickListener" />

    </data>

    <androidx.constraintlayout.widget.ConstraintLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent">

        <androidx.appcompat.widget.AppCompatTextView
            android:id="@+id/user_id"
            android:layout_width="0dp"
            android:layout_height="wrap_content"
            android:background="@android:color/holo_green_light"
            android:gravity="center"
            android:onClick="@{()->clickListener.onUserIDClick()}"
            android:paddingVertical="15dp"
            android:text="@{@string/user_data(user.id, user.name)}"
            android:textColor="@android:color/white"
            app:layout_constraintEnd_toEndOf="parent"
            app:layout_constraintStart_toStartOf="parent"
            app:layout_constraintTop_toTopOf="parent" />

        <androidx.appcompat.widget.AppCompatTextView
            android:id="@+id/user_name"
            android:layout_width="0dp"
            android:layout_height="wrap_content"
            android:background="@android:color/holo_red_light"
            android:gravity="center"
            android:onClick="@{()->clickListener.onUserNameClick()}"
            android:paddingVertical="15dp"
            android:text="@{user.name, default=`sunzn is a man`}"
            android:textColor="@android:color/white"
            app:layout_constraintEnd_toEndOf="parent"
            app:layout_constraintStart_toStartOf="parent"
            app:layout_constraintTop_toBottomOf="@id/user_id" />

    </androidx.constraintlayout.widget.ConstraintLayout>

</layout>