24、DataBinding与DataBindingComponent：全局组件配置、自定义Converter、自定义Mapper、组件复用

说实话，DataBinding 学到这个阶段，很多同学会卡在一个地方：怎么让 DataBinding 更灵活？ 比如全局统一处理某个类型、自定义转换逻辑、或者复用组件。

嗯，这就要聊到 DataBindingComponent 了。它就像 DataBinding 的「插件系统」。你可以通过它，注入全局的转换器、映射器，甚至复用组件。

我在项目中遇到过几次类似场景：后端返回的时间戳格式不统一，有的用秒，有的用毫秒。如果每个页面都写转换逻辑，那代码就太「脏」了。用 DataBindingComponent 统一处理，清爽很多。

什么是 DataBindingComponent？

说白了，DataBindingComponent 是一个接口。它定义了 DataBinding 在解析表达式时，如何调用自定义的转换逻辑。

默认情况下，DataBinding 会使用内置的 Component。但你可以通过自定义 Component，覆盖或扩展它的行为。

自定义 Converter：统一处理类型转换

先看一个最常见的场景：把时间戳转成可读的日期字符串。

你想想看，如果每个 ViewModel 里都写 SimpleDateFormat，那得多烦？而且容易出 bug（比如线程安全问题）。

用 DataBindingComponent 可以这样搞：

// 1. 定义 Converter 接口
interface MyConverter {
    @BindingConversion
    fun convertTimestampToDate(timestamp: Long): String {
        val sdf = SimpleDateFormat("yyyy-MM-dd HH:mm", Locale.getDefault())
        return sdf.format(Date(timestamp))
    }
}

// 2. 实现 DataBindingComponent
class MyDataBindingComponent : DataBindingComponent {
    override fun getMyConverter(): MyConverter {
        return MyConverterImpl()
    }
}

// 3. 在布局中使用
<TextView
    android:text="@{converter.convertTimestampToDate(viewModel.timestamp)}" />

自定义 Mapper：处理复杂的数据映射

有时候，我们不只是做简单的类型转换。比如：把一个用户 ID 映射成用户头像 URL。

这种场景下，Converter 就不够用了。因为你需要依赖外部数据（比如用户信息表）。

这时候可以用 Mapper 模式：

// 定义 Mapper 接口
interface UserMapper {
    fun mapUserIdToAvatar(userId: String): String
}

// 实现 DataBindingComponent
class MyDataBindingComponent(
    private val userMapper: UserMapper
) : DataBindingComponent {
    override fun getUserMapper(): UserMapper = userMapper
}

// 布局中使用
<ImageView
    app:imageUrl="@{mapper.mapUserIdToAvatar(viewModel.userId)}" />

我曾经在一个社交 App 里用过这个模式。后端只返回用户 ID，前端需要根据 ID 去本地缓存或网络获取头像。用 Mapper 统一处理，所有页面都复用同一套逻辑。

组件复用：避免重复造轮子

你有没有遇到过这种情况：多个页面都用同一个自定义 View，但每个页面都要写一遍绑定逻辑？

嗯，这就是组件复用的痛点。用 DataBindingComponent 可以解决：

// 定义一个可复用的组件接口
interface AvatarComponent {
    fun loadAvatar(imageView: ImageView, userId: String)
}

// 实现 DataBindingComponent
class MyDataBindingComponent(
    private val avatarComponent: AvatarComponent
) : DataBindingComponent {
    override fun getAvatarComponent(): AvatarComponent = avatarComponent
}

// 布局中复用
<include layout="@layout/common_avatar"
    app:avatarComponent="@{component.avatarComponent}"
    app:userId="@{viewModel.userId}" />

这样，所有用到头像的地方，都通过同一个 AvatarComponent 来处理。如果以后要换图片加载库，只需要改这一个地方。

全局配置：如何注入 DataBindingComponent

光定义好 DataBindingComponent 还不够，你得告诉 DataBinding 用哪个。

有两种方式：

方式	说明	适用场景
全局默认	在 Application 中设置默认 Component	整个 App 统一使用一套转换逻辑
局部覆盖	在 Activity 或 Fragment 中传入自定义 Component	某个页面需要特殊处理

全局默认的方式：

class MyApp : Application() {
    override fun onCreate() {
        super.onCreate()
        DataBindingUtil.setDefaultComponent(MyDataBindingComponent())
    }
}

局部覆盖的方式：

val binding = DataBindingUtil.setContentView<ActivityMainBinding>(
    this, R.layout.activity_main,
    MyDataBindingComponent()
)

知识体系图

下面这张图帮你理清 DataBindingComponent 的核心逻辑：

避坑指南

最后，分享几个我踩过的坑：

• 我曾经在 DataBindingComponent 里写了网络请求，结果 UI 卡顿。记住：Component 里只做同步转换，异步操作交给 ViewModel。
• 我曾经忘记在 Application 里设置默认 Component，结果自定义的 Converter 死活不生效。检查一下 DataBindingUtil.setDefaultComponent() 有没有调用。
• 注意：如果同时用了 @BindingConversion 和 DataBindingComponent，@BindingConversion 的优先级更高。但我不建议混用，容易混乱。

好了，这一章的内容就到这里。记住：DataBindingComponent 是 DataBinding 的「瑞士军刀」，用好了能大幅提升代码复用率。