本文主要介绍DataBindingAndroid App中的使用方法。数据绑定是将“提供器”的数据源与“消费者”绑定并使其同步的一种通用技术。

1. Android应用程序使用数据绑定

1.1 介绍DataBinding

Android通过DataBinding提供了编写声明型布局的支持。这样可以最大程度简化布局逻辑相关联的代码。

数据绑定要求修改文件,外层需要包裹一个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="mainModel"
            type="me.ithome.jetpack.model.MainViewModel" /></data>

    <androidx.constraintlayout.widget.ConstraintLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        tools:context=".MainActivity"><TextView
            android:id="@+id/tv_userinfo"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="@{mainModel.userData.toString()}"
            app:layout_constraintBottom_toBottomOf="parent"
            app:layout_constraintLeft_toLeftOf="parent"
            app:layout_constraintRight_toRightOf="parent"
            app:layout_constraintTop_toTopOf="parent" />

        <Button
            android:id="@+id/button"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_marginTop="56dp"
            android:onClick="@{(view) -> mainModel.getClick(view)}"
            android:text="@string/btn_getUserInfo"
            app:layout_constraintBottom_toTopOf="@+id/tv_userinfo"
            app:layout_constraintEnd_toEndOf="parent"
            app:layout_constraintHorizontal_bias="0.498"
            app:layout_constraintStart_toStartOf="parent"
            app:layout_constraintTop_toTopOf="parent" />

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

①用户变量,定义了能在这个布局里面使用的属性和类
②常规布局

DataBinding会基于layout创建一个Binding class,这个类包含了布局属性(定义的变量)到相关视图的所有绑定,并且会为布局中的数据元素生成setter,生成的类的名称是基于layout的名称(驼峰命名,加上Binding后缀)。比如布局名是activity_main.xml,生成的类就是ActivityMainBinding。你能通过这个类去inflate布局和数据模型,也可以通过DataBindingUtil类。

  1. DataBindingUtils加载布局
val mainBindingUtil = DataBindingUtil.setContentView<ActivityMainBinding>(this, R.layout.activity_main)
mainBindingUtil.lifecycleOwner = this
  1. inflate加载布局(此方法也能用于RecyclerView, ViewPager)
val mainBindingUtil = ActivityMainBinding.inflate(layoutInflater)
setContentView(mainBindingUtil.root)

上述两种方法大家二选一,一般在Activity中我们都用第一种。

1.2 如何启用DataBinding

想要在Android App工程中使用databinding,只需要在app/build.gradle文件中设置如下代码:

android {
    ....
    dataBinding {
        enabled = true
    }
}

1.3 DataBinding点击事件的处理

布局的处理除了数据的传递,还有点击事件的处理。 使用方式和普通方法调用一样。比如我在MainViewModel.kt中定义了getClick方法

fun getClick(v: View) {
    //TODO
}

现在我想在Button点击的时候调用getClick方法,只需要在布局文件中添加下面的代码

android:onClick="@{(view) -> mainModel.getClick(view)}"

如果不需要参数,可以直接

android:onClick="@{() -> mainModel.getClick()}"

如果有其他参数,对应的添加参数列表

android:onClick="@{() -> mainModel.getClick(args)}"

其他比如onLongClick之类的处理都是同理。

1.4 import的使用

可以通过import的方式导入类,直接调用类的静态方法。

<data>
    <import type="me.ithome.jetpack.utils.StringUtils" />
    <variable
        name="mainModel"
        type="me.ithome.jetpack.model.MainViewModel" />
</data>

<TextView
   android:text="@{StringUtils.capitalize(mainModel.userData.name)}"
   android:layout_width="wrap_content"
   android:layout_height="wrap_content"/>

1.5 数据实时刷新

viewmodel的数据发生变化后,我们希望布局也同时刷新,有个非常简单的方法,不需要继承BaseObservable,我们通过引入LiveData来实现。

open class MainViewModel : ViewModel() {

    var userData: MutableLiveData<UserInfo> = MutableLiveData()

    init {
        getUserInfo()
    }

    private fun getUserInfo() {
        val user = UserInfo("李四", (10..50).random())
        userData.postValue(user)   //数据发生变化后,调用postValue,无需通过observe监听,布局数据会自动刷新
    }

    fun getClick(v: View) {
        getUserInfo()
    }
}

1.6 使用BindingAdapter

可以通过BindingAdapter这个注解来实现属性值变化的时候,控件状态也跟着变化,比如图片ImageView,当url变化的时候,控件会跟着显示不同的图片。

需要在静态类里面定义一个静态方法:

object StringUtils {

    @BindingAdapter("android:src")
    @JvmStatic fun loadImage(view: ImageView, url: String) {
        MyApplication._context?.let {
            Glide.with(it)
                .load(url)
                .into(view)
        }
    }
}

注意这里的android:src,这个可以直接指定控件的属性,也可以自己定义属性。

<ImageView
            android:id="@+id/imageView"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            app:layout_constraintBottom_toBottomOf="parent"
            app:layout_constraintEnd_toEndOf="parent"
            app:layout_constraintStart_toStartOf="parent"
            app:layout_constraintTop_toBottomOf="@+id/tv_userinfo"
            android:src="@{mainModel.imageUrl}"
            tools:srcCompat="@tools:sample/avatars" />

loadImage方法绑定的是android:src这个属性,所以当这个属性的值变化时会把viewurl传递到loadImage

如果是绑定的自定义字段呢?比如我现在绑定了一个自定义的url

@BindingAdapter("url")
@JvmStatic fun loadImage(view: ImageView, url: String) {
...
}

那么布局文件就这么写

<ImageView
            android:id="@+id/imageView"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            app:layout_constraintBottom_toBottomOf="parent"
            app:layout_constraintEnd_toEndOf="parent"
            app:layout_constraintStart_toStartOf="parent"
            app:layout_constraintTop_toBottomOf="@+id/tv_userinfo"
            app:url="@{mainModel.imageUrl}"
            tools:srcCompat="@tools:sample/avatars" />

总结

前面主要是写了databinding的一些基本用法,扩展用法还比较多,我们后续再接着说。