5、DataBinding：DataBinding基础、双向绑定、BindingAdapter与自定义属性

各位同学，今天我们来聊聊DataBinding。说实话，这个组件刚出来的时候，我内心是拒绝的——「又搞一套模板语法？XML里写逻辑？这不是开倒车吗？」

但后来真香了。尤其是接手过一个几千行Activity的项目之后，我深刻体会到：数据驱动UI，才是Android开发的终极解药。

一句话总结：DataBinding让你在XML里直接绑定数据，省去findViewById和setText的重复劳动。它不是一个新框架，而是一种声明式UI的编程范式。

5.1 DataBinding基础：从配置到第一个绑定

先说说怎么开启。在app级别的build.gradle里加上这段：

android {
    ...
    buildFeatures {
        dataBinding = true
    }
}

嗯，就这么简单。然后你的布局文件需要稍微改造一下——用<layout>标签包住原来的根布局。

举个例子，以前我们写一个展示用户信息的布局：

<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android">
    <data>
        <variable
            name="user"
            type="com.example.User" />
    </data>

    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:orientation="vertical">

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

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

    </LinearLayout>
</layout>

看到@{user.name}了吗？这就是DataBinding的核心语法——花括号加@符号，里面写表达式。它会在运行时自动把User对象的name属性塞进TextView。

在Activity里怎么用呢？

val binding: ActivityMainBinding = DataBindingUtil.setContentView(this, R.layout.activity_main)
binding.user = User("张三", 25)

就这么两行。没有findViewById，没有setText。数据变了，UI自动跟着变——前提是你的数据是可观察的，这个我们后面再说。

个人习惯：我一般把Binding对象命名为binding，简单明了。团队里统一命名规范，比什么都重要。

5.2 双向绑定：数据与UI的「双向奔赴」

单向绑定是数据→UI，双向绑定就是数据⇄UI。最典型的场景就是EditText——用户输入内容，数据模型要同步更新。

语法很简单，把@换成@=：

<EditText
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:text="@={user.name}" />

注意那个@=，多了一个等号。它表示：当用户输入时，自动把输入内容写回user.name。

但这里有个坑——数据必须实现Observable接口。我刚开始用的时候，发现EditText改了，但数据没更新，排查了半天。后来才意识到，普通的Java Bean不行，得用ObservableField或者LiveData。

class User {
    val name = ObservableField<String>("张三")
    val age = ObservableInt(25)
}

或者用LiveData：

class UserViewModel : ViewModel() {
    val name = MutableLiveData<String>("张三")
    val age = MutableLiveData<Int>(25)
}

然后在XML里绑定LiveData时，需要设置LifecycleOwner：

binding.lifecycleOwner = this  // Activity或Fragment

我曾经踩过的坑：双向绑定配合LiveData时，如果不设置LifecycleOwner，数据不会自动更新。而且要注意避免循环更新——UI变化触发数据变化，数据变化又触发UI刷新。好在DataBinding内部做了防抖处理，一般不会出问题。

5.3 BindingAdapter：自定义属性的「魔法」

BindingAdapter是DataBinding最强大的功能之一。它允许你为任何View定义自定义属性，然后在XML里用app:xxx的方式使用。

举个例子，加载网络图片是Android开发的日常。用BindingAdapter可以封装一个通用的图片加载逻辑：

@BindingAdapter("imageUrl")
fun loadImage(view: ImageView, url: String?) {
    url?.let {
        Glide.with(view.context)
            .load(it)
            .into(view)
    }
}

然后在XML里：

<ImageView
    android:layout_width="100dp"
    android:layout_height="100dp"
    app:imageUrl="@{user.avatarUrl}" />

你看，一行代码都不用写，图片就加载好了。这就是BindingAdapter的魅力——把重复的模板代码封装到注解里。

BindingAdapter还可以接收多个参数：

@BindingAdapter(value = ["imageUrl", "placeholder"], requireAll = false)
fun loadImage(view: ImageView, url: String?, placeholder: Drawable?) {
    Glide.with(view.context)
        .load(url)
        .placeholder(placeholder ?: ContextCompat.getDrawable(view.context, R.drawable.ic_default))
        .into(view)
}

requireAll = false表示这两个属性不是必须同时出现。你可以在XML里只写app:imageUrl，不写app:placeholder，也不会报错。

我建议：把常用的BindingAdapter封装到一个单独的类里，比如BindingAdapters.kt。这样团队里所有人都能复用，而且容易维护。我见过有些项目把BindingAdapter散落在各个ViewModel里，那叫一个乱。

5.4 自定义属性：让XML「听懂」你的业务

除了BindingAdapter，DataBinding还支持自定义属性。说白了，就是给已有的View添加新的XML属性。

比如，我们想让一个TextView根据某个条件显示不同的颜色：

@BindingAdapter("textColorByStatus")
fun setTextColorByStatus(textView: TextView, status: Int) {
    val color = when (status) {
        0 -> Color.GRAY
        1 -> Color.GREEN
        2 -> Color.RED
        else -> Color.BLACK
    }
    textView.setTextColor(color)
}

XML里：

<TextView
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    app:textColorByStatus="@{order.status}" />

这样，订单状态一变，颜色自动跟着变。不用在Activity里写一堆if-else。

再比如，自定义一个「防重复点击」的属性：

@BindingAdapter("onThrottleClick")
fun setOnThrottleClick(view: View, onClick: View.OnClickListener) {
    view.setOnClickListener {
        // 500ms内只响应一次
        val now = System.currentTimeMillis()
        if (now - lastClickTime > 500) {
            lastClickTime = now
            onClick.onClick(it)
        }
    }
}

private var lastClickTime = 0L

XML里：

<Button
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    app:onThrottleClick="@{() -> viewModel.submit()}" />

这个技巧我在项目里用了很久，有效防止了用户疯狂点击导致的重复提交问题。

5.5 知识体系总览

说了这么多，我们来画一张图，把DataBinding的核心脉络理清楚：

DataBinding 知识体系 DataBinding 基础绑定 • layout + data 标签 • @{} 表达式语法 • DataBindingUtil.setContentView • 自动生成 Binding 类 双向绑定 • @={} 语法 • ObservableField / LiveData • 设置 LifecycleOwner • 避免循环更新 BindingAdapter • @BindingAdapter 注解 • 多参数支持 • requireAll 控制 • 封装通用逻辑 自定义属性 • 扩展已有 View 属性 • 业务逻辑封装到 XML 数据源 • ObservableField / ObservableInt • LiveData + ViewModel

这张图把DataBinding的五个核心模块串起来了。你可以看到，基础绑定是地基，双向绑定是交互，BindingAdapter是扩展，自定义属性是灵活，数据源是灵魂。缺一个，用起来都不够顺手。

5.6 避坑指南与最佳实践

最后，分享几个我这些年积累的经验：

  • 不要滥用表达式：XML里的表达式应该保持简单。复杂的逻辑放到ViewModel里，XML只做数据展示和事件绑定。我曾经见过有人在XML里写三目运算符嵌套，那代码简直没法看。
  • BindingAdapter命名要规范：我习惯用setXxx或者直接描述功能，比如loadImage、formatPrice。不要用myCustomAttr这种名字，别人看不懂。
  • 注意空安全：DataBinding默认会做空检查，但如果你用了!!操作符，小心NPE。我建议在ViewModel里做好空值处理，XML里尽量用?.。
  • 性能问题：DataBinding在编译期生成代码，运行时几乎没有性能损耗。但如果你在列表里用了大量复杂的BindingAdapter，建议做一下性能测试。我遇到过Glide加载图片时，BindingAdapter频繁触发导致卡顿的情况，后来加了缓存才解决。

核心原则：DataBinding是工具，不是银弹。它最适合的场景是数据驱动的UI更新和减少模板代码。如果你的页面逻辑极其复杂，或者需要频繁操作View的动画，那还是老老实实用传统方式吧。

好了，DataBinding的内容就讲到这里。记住，实践出真知——打开你的项目，试着把一个简单的页面改成DataBinding，你会感受到那种「数据一变，UI自动刷新」的快感。

公众号:蓝海资料掘金营，微信deep3321
← 上一章 📖 返回目录 下一章 →