Android DataBinding双向绑定：BaseObservable与ObservableField详解

在Android MVVM架构中，实现数据与UI的同步是核心诉求。DataBinding作为JetPack组件库的重要成员，为此提供了优雅的解决方案。本文将深入探讨如何利用BaseObservable与ObservableField实现视图（View）与数据模型（ViewModel）之间的双向绑定。

单向绑定与双向绑定

在开始代码实践前，需要明确两个基本概念：

• 单向绑定：当数据对象（Field）发生变化时，与之绑定的UI控件（如TextView）会自动更新，数据流是单向的。
• 双向绑定：在单向绑定的基础上，当用户在UI控件（如EditText）中输入内容时，数据对象的值也会同步更新，数据流是双向的。

下图清晰地展示了二者的区别：

使用 BaseObservable 实现双向绑定

BaseObservable是一个基类，通过继承它并配合@Bindable注解，可以手动控制属性的通知。

1. 启用 DataBinding

首先，在app模块的build.gradle文件中启用DataBinding。

android {
    compileSdkVersion 29
    buildToolsVersion "30.0.3"
    dataBinding {
        enabled = true
    }
}

2. 编写布局文件 (activity_main.xml)

在布局文件中，使用<layout>标签包裹，并定义数据变量。注意，双向绑定的表达式使用@={}。

<?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"
    xmlns:tools="http://schemas.android.com/tools">

    <data>
        <variable
            name="userViewModel"
            type="com.example.baseobservable.UserViewModel" />
    </data>

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

        <EditText
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="@={userViewModel.userName}"
            app:layout_constraintBottom_toBottomOf="parent"
            app:layout_constraintLeft_toLeftOf="parent"
            app:layout_constraintRight_toRightOf="parent"
            app:layout_constraintTop_toTopOf="parent" />

    </androidx.constraintlayout.widget.ConstraintLayout>
</layout>

3. 数据模型 (User.java)

这是一个简单的POJO类，用于承载数据。

package com.example.baseobservable;

public class User {
    public String userName;

    public User(String userName) {
        this.userName = userName;
    }
}

4. 视图模型 (UserViewModel.java)

这是实现双向绑定的核心。类继承BaseObservable，getter方法使用@Bindable注解，在setter方法中调用notifyPropertyChanged()通知UI更新。

package com.example.baseobservable;

import android.util.Log;
import androidx.databinding.BaseObservable;
import androidx.databinding.Bindable;

public class UserViewModel extends BaseObservable {
    private User user;

    public UserViewModel() {
        this.user = new User("Jack");
    }

    // 用 @Bindable 注解标记，该属性参与绑定
    @Bindable
    public String getUserName() {
        return user.userName;
    }

    // 当EditText内容变化时，此方法被调用
    public void setUserName(String userName) {
        if(userName != null && !userName.equals(user.userName)) {
            user.userName = userName;
            Log.d("TAG_DB", "用户名更新为: " + userName);
            // 通知UI属性已变化，BR.userName在编译后自动生成
            notifyPropertyChanged(BR.userName);
        }
    }
}

5. 绑定 Activity (MainActivity.java)

在Activity中，使用DataBindingUtil设置布局并绑定ViewModel。

package com.example.baseobservable;

import androidx.appcompat.app.AppCompatActivity;
import androidx.databinding.DataBindingUtil;
import android.os.Bundle;
import com.example.baseobservable.databinding.ActivityMainBinding;

public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        ActivityMainBinding binding = DataBindingUtil.setContentView(this, R.layout.activity_main);
        binding.setUserViewModel(new UserViewModel());
    }
}

6. 运行效果

运行应用后，EditText初始显示“Jack”。当用户在输入框中修改内容时，UserViewModel中的setUserName方法会被触发，日志将打印新的值，实现了双向绑定。

使用 ObservableField 实现双向绑定

ObservableField是更轻量级的实现方式，它包装了基本类型或对象，使其变得可观察。相比BaseObservable，它无需继承和手动调用notify方法，代码更简洁。

修改 UserViewModel.java

我们主要修改UserViewModel，不再继承BaseObservable，而是使用ObservableField<User>来持有数据。

package com.example.baseobservable;

import android.util.Log;
import androidx.databinding.ObservableField;

public class UserViewModel {
    // 使用ObservableField包装User对象
    private ObservableField<User> userObservableField;

    public UserViewModel() {
        User user = new User("Jack");
        userObservableField = new ObservableField<>();
        userObservableField.set(user);
    }

    public String getUserName() {
        // 从ObservableField中获取User对象再取字段
        return userObservableField.get().userName;
    }

    public void setUserName(String userName) {
        Log.d("TAG_DB", "用户名更新为: " + userName);
        // 直接修改ObservableField中User对象的字段
        userObservableField.get().userName = userName;
        // ObservableField会自动通知UI更新
    }
}

注意：使用ObservableField时，布局文件(activity_main.xml)和Activity中的绑定代码无需任何改变。这正是DataBinding框架的优势——它统一了数据变化的通知机制，无论底层使用哪种可观察类型。

总结与选择

• BaseObservable：适合在自定义的ViewModel中有多个属性需要独立观察和控制时使用，灵活性更高。
• ObservableField：代码更简洁，适合包装单个字段或简单对象，由框架自动处理通知逻辑。

两者都能有效实现UI与数据的双向同步，是构建响应式Android应用的基础。开发者可以根据项目的复杂度和个人偏好进行选择。掌握这两种方式，是深入学习Android JetPack中LiveData、ViewModel等组件的重要前提。