Android之MVVM架构指南(二):DataBinding

Android 196 2018-10-24 16:55

DataBinding 出现的目的旨在取代findViewById()方法,但是它的功能不仅如此。

配置

  1. build.gradle中开启功能
android {
    ...
    dataBinding {
        enabled = true
    }
}
  1. gradle.properties中启用新的编译器
android.databinding.enableV2=true

基本操作

实现一个databinding基本上需要完成三个步骤的工作

1. 创建数据源

即普通的JavaBean对象。

2. 在xml中定义

Databinding支持的布局文件跟标签是固定<layout>标签,且需要一个<data>标签来声明数据源。

<?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
        <-- 布局文件 !-->
   </LinearLayout>
</layout>

上述xml文件中,<variable>标签就是声明一个在xml中可用的变量,里面的两个属性分别对应的是变量名和变量类型。

有了数据源的变量,我们就可以把它绑定给指定的控件:

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

3. 在activity中使用

Android 开发者官方文档上说,当你创建了一个databinding类型的布局文件后,gradle 编译器会自动生成一个与之对应的绑定类。

绑定类的命名规则为:驼峰化xml文件名 + Binding.java

在activity中的获取方式为:

ActivityMainBinding binding = DataBindingUtil.setContentView(this, R.layout.activity_main);

有了binding对象后你就可以直接使用布局文件中的控件了:

// 控件的变量名就是布局文件中的id名
binding.name.setBackgroundColor(Color.WHITE);

当然我们并不需要手动为每个空间赋值,只需要:

User user = new User("Test", "User");
binding.setUser(user);

点击事件

点击事件的监听有两种方法:

  1. 直接调用方法。这种跟之前在activity里设置onclick有些类似,注册的方法必须是onClick(View view)形式的带着View参数的,使用方法是:
android:onClick="@{objectName::funName}"
  1. 绑定监听器。这种方法对于注册的方法没有任何要求,有参数没有参数的,参数类型是什么样的都没有限制,使用方法是:
android:onClick="@{() -> presenter.onSaveClick(task)}"

这是一个lamda表达式,小括号里的view参数根据自己需求填不填都可以,就相当于在此处注册了一个监听器。

显然第二种方法要更加的灵活,不仅可以根据需要传递任何参数,而且还不会强制要求注册方法必须传递view参数。

RecyclerView中使用

在adapter中实现:

@Override
public void onBindViewHolder(@NonNull ViewHolder viewHolder, int i) {
    Test test = data.get(i);
    viewHolder.itemListBinding.setVariable(BR.test,test);
}

class ViewHolder extends RecyclerView.ViewHolder {

    private ItemListBinding itemListBinding;

    ViewHolder(@NonNull View itemView) {
        super(itemView);
        itemListBinding = DataBindingUtil.bind(itemView);
    }
}

BR是自动生成的类,包含了所有的layout标签下的variable变量id。

绑定适配器

在开发过程中除了文字类标准的数据外,还有比较特殊的数据,例如从网络上加载一张图片我们就不能直接在XML中直接绑定了,这时候就需要绑定适配器了。自定义一个绑定适配器很简单:

public class ImageUtil {

    @BindingAdapter({"imageUrl"})
    public static void showImage(ImageView imageView, String url) { 
          //被注释的方法必须是静态的。
        Glide.with(imageView.getContext()).load(url).into(imageView);
    }
}

接下来在XML中直接使用即可:

<ImageView app:imageUrl="@{user.imageUrl}" />

实现原理简述

DataBinding 并是不真的把findViewById()替换掉了,而是相当于对findViewById()的封装,Android插件会自动把根标签<layout>的布局转换为对应的绑定类。

下一节

Android之MVVM架构指南(三):Lifecycle

文章评论