Android DataBinding 笔记一

• Android DataBinding 笔记一
• Android DataBinding 笔记二
• Android DataBinding 笔记三
• Android DataBinding 笔记四
• 源码

官网介绍，DataBinding是用于将数据的和视图绑定在一起的支持库，特点是只需要在视图定义的xml中编写绑定信息，减少在代码中的视图于数据的交互逻辑。

这样可以分离数据和视图，减少这两个模块在代码层面上的耦合。

启用功能

在项目的build.gradle中添加如下代码即可：

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

常见问题：

• DSL element ‘android.dataBinding.enabled’ is obsolete and has been replaced with ‘android.buildFeatures.dataBinding’.参考：https://blog.youkuaiyun.com/qq_40533422/article/details/106838495

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

• If you plan to use data binding in a Kotlin project, you should apply the kotlin-kapt plugin. 如果是使用Kotlin开发需要启用Kotlin插件，不然可能会有莫名其妙的问题。

  plugins {
    ...
    id 'kotlin-kapt'
  }
  

基础的绑定用法

更详细的用法参考官网的布局和绑定表达式，基础绑定用法示例：

const val TAG = "databinding"
class MainActivity : AppCompatActivity() , View.OnClickListener{
    lateinit var activityMainBinding: ActivityMainBinding
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        activityMainBinding = DataBindingUtil.setContentView(this, R.layout.activity_main)
        activityMainBinding.aty = this
        activityMainBinding.data = SimpleData("Jack")
    }
    override fun onClick(v: View?) {
        Log.d(TAG, "onClick: v = $v")
    }
    fun doClick() {
        Log.d(TAG, "doClick: called")
    }
}

其中 MainActivity 的 ActivityMainBinding （这个叫做绑定类）是根据布局文件和其名称自动生成的，需要注意的是，任何情况下都不应该自己实现绑定类，这个一定要交给DataBinding来生成。对应的布局文件如下，一共两个：

<layout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:bind="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools">
    <data>
        <variable name="aty" type="com.im_hero.databinding.MainActivity" />
        <variable name="data" type="com.im_hero.databinding.data.SimpleData" />
    </data>
    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:orientation="vertical"
        tools:context=".MainActivity">
        <!-- Data Binding -->
        <TextView
            android:id="@+id/tvDataName"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:text="@{data.name}" />
        <!-- Reference of id -->
        <TextView
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:text="@{tvDataName.text}" />
        <!-- Plurals usage -->
        <TextView
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:text="@{@plurals/banana(1, 1)}" />
        <!-- format string -->
        <TextView
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:text="@{@string/format_name(`Jason`)}" />
        <!-- Event Listener -->
        <TextView
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:background="#99FF22"
            android:onClick="@{aty::onClick}"
            android:text="@string/event_listener" />
        <!-- Lambda Event Listener -->
        <TextView
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:background="#99FF22"
            android:onClick="@{(v) -> aty.doClick()}"
            android:text="@string/lambda_event_listener" />
        <!-- Include element data binding -->
        <include
            layout="@layout/include_data"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            bind:aty="@{aty}"
            bind:data="@{data}" />
    </LinearLayout>
</layout>

第二个布局是被 include 标签引用的，include_data 布局，可以用过 bind:aty="@{aty} 和 bind:data="@{data}" 这种语法将数据传递给被引用的布局：

<layout xmlns:android="http://schemas.android.com/apk/res/android">
    <data>
        <variable name="aty" type="com.im_hero.databinding.MainActivity" />
        <variable name="data" type="com.im_hero.databinding.data.SimpleData" />
    </data>
    <TextView
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="@{`aty = ` + aty + `, data = ` + data}" />
</layout>

运行结果如下图：