Android基于DataBinding封装RecyclerView实现快速列表

分类：Android作者：码中之牛

作者：loongwind
转载地址：https://juejin.cn/post/7119129384727871496

1. 前言

在移动应用开发中，列表组件是一个非常常见的 UI 组件，绝大多数应用开发中都会使用到列表组件进行界面的开发，在 Android 开发中列表组件一般使用官方提供的 RecyclerView ，而 RecyclerView 的常规开发需要手动创建对应的 Adapter、ViewHolder 代码，且每个 RecyclerView 的使用都需要编写这种的样板代码，存在重复代码，降低了开发效率，于是为了提高列表的开发效率（偷懒）就有了各种对 RecyclerView 封装的框架来简化其开发流程，本篇就是其中一种框架的实现。

先给框架起个名字吧，emmm… 起名什么的真的是太难了，比写代码难多了，最后绞尽脑汁的想了一个 ardf，英文 “android rapid development framework” 的缩写，即 “Android 快速开发框架”，很好，已经完成这个框架的 50% 工作了。

2. 实现思路

名字想好了，下一步就是想想怎么来实现，框架的核心目的是简化开发流程，对于 RecyclerView 开发来说，RecyclerView 的创建 和 item 的布局肯定是必不可少的，于是只能从 Adapter 和 ViewHolder 来着手简化，Adapter 和 ViewHolder 的作用主要是为了加载 item 的布局和对 item 的展示数据和事件进行处理，如果能把这一块做成通用的就不用每次都创建 Adapter 和 ViewHolder 了。

最后想到了使用 DataBinding 来进行封装，通过 DataBinding 的扩展将 item 布局、列表数据及事件都通过 xml 设置到 Adapter 里，在 Adapter 里再通过 DataBinding 加载 item 的布局文件最终创建 ViewHolder 并进行数据绑定，从而减少 Adapter 和 ViewHolder 的开发代码。

DataBinding 是 Google 官方的一个数据绑定框架，借助该库，您可以声明式的将应用中的数据源绑定到布局中的界面组件上，实现通过数据驱动界面更新，从而降低布局和逻辑的耦合性，使代码逻辑更加清晰。更多关于 DataBinding 的介绍请查阅 Google 官方文档：DataBinding

封装后与封装前的开发流程对比：

可以发现，使用 ardf后不需要再创建 Adapter 和 ViewHolder，且设置数据的方式改成了使用 DataBinding 绑定的方式，降低了界面与逻辑的耦合，从而大幅度的减少样板代码编写，提升开发效率。

3. 使用

既然是为了提高开发效率、简化开发流程的框架，那就先看看实际使用效果怎么样，是不是有说的那么好，show me the code 走起。

3.1 扩展属性介绍

ardf通过 DataBinding 的 BindingAdapter 扩展了 RecycleView 一系列属性，用于在 xml 布局中对 RecyclerView 进行快捷配置，无需编写 java/kotlin 代码即可完成对 RecyclerView 的全部配置，包括列表数据、item 布局、事件等，具体可配置属性如下:

具体使用方法可参考 3.3、3.4、3.5、3.6 的使用介绍。

3.2 项目配置

在项目 Module 的 build.gradle 文件中添加封装好的依赖库，已经上传 mavenCentral，如下：

dependencies {
    implementation 'com.loongwind.ardf:recyclerview-ext:1.0.0'
}

因 ardf基于 DataBinding 实现，所以需要使用该库的 Module 的 build.gradle 里的 android 配置下启用 DataBinding，启用方式如下：

android {
    ...
    buildFeatures {
        dataBinding true
    }
}

同时在插件中添加 kotlin-kapt的插件，如下：

plugins {
    id 'com.android.application'
    id 'org.jetbrains.kotlin.android'
    id 'kotlin-kapt'
}

ardf 的使用配置就完成了，点击 Sync Now同步 build.gradle 生效后即可进行代码开发。

3.3 简单使用

先看一下结合 MVVM 架构如何快速实现简单的列表数据显示以及列表数据更新功能。

3.3.1 准备列表数据

先创建一个 ViewModel 用于存放列表的数据，这里主要演示列表的开发就直接用一个普通的类而不是 Jetpack 的 ViewModel 库，代码如下：

class RecycleViewModel(){
    val data = ArrayList<String>()

    init {
        for (i in 0..5){
            data.add("Item $i")
        }
    }
}

代码很简单，有一个 List 类型的 data 变量，里面存放的是 String 类型的数据，在初始化的时候向里面添加了 5 条测试数据。

3.3.2 创建 item 布局

创建列表的 item 布局文件 layout_item.xml， 简单添加一个 TextView 进行演示，代码如下：

<?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">

    <data>
        <!--通过 DataBinding 接收 item 数据-->
        <variable
            name="item"
            type="String" />

    </data>

    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:orientation="vertical"
        android:paddingVertical="2dp">

        <TextView
            android:id="@+id/text"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:gravity="center"
            android:padding="15dp"
            android:text="@{item}" // 使用 DataBinding 进行数据绑定
            android:background="#7AEDEBEB"/>

    </LinearLayout>
</layout>

布局里通过 DataBinding 传入了一个 String 类型的 item 变量，并将这个变量绑定到了 TextView 的 text 属性上，即对 TextView 设置显示的字符串值，这里需要注意以下两点：

  • 变量名必须为 item，因为这是框架里封装好的，名称不对无法自动接收传递过来的数据
  • item 的数据类型需跟前面 ViewModel 中定义的列表中的数据类型一致，也就是与上面定义的 data 里子元素类型一致

3.3.3 创建 RecyclerView

数据和 item 布局都准备好了，下面就是在页面的 activity_recycleview_simple.xml 布局里创建 RecyclerView 了，代码如下：

<?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">

    <data>
        <!--  通过 DataBinding 接收 ViewModel 实例  -->
        <variable
            name="viewModel"
            type="com.loongwind.ardf.demo.RecycleViewModel" />

    </data>

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

        <androidx.recyclerview.widget.RecyclerView
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            app:layoutManager="androidx.recyclerview.widget.LinearLayoutManager"
            app:data="@{viewModel.data}"  // 绑定列表数据
            app:itemLayout="@{@layout/layout_item}"/>  // 绑定 item 布局

    </LinearLayout>
</layout>

布局里通过 DataBinding 接收一个 RecycleViewModel 类型的 viewModel 变量，也就是第 1 步准备数据的 RecycleViewModel 类的实例。

xml 里 RecyclerView 设置主要分为三步：

  • 设置 layoutManger
  • 通过 data属性绑定列表数据
  • 通过 itemLayout 属性绑定 item 布局

一定不要忘了设置 layoutManger，在实际开发中经常有小伙伴忘记设置这个属性导致列表不显示而排查半天原因浪费大量的时间

3.3.4 Activity 中使用

接下来就是在 Activity 中使用了，即加载第 3 步创建的 layout 布局，并将 RecycleViewModel 的实例通过 DataBinding 传到布局里去。代码如下：

class RecycleViewSimpleActivity : AppCompatActivity(){

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        // 加载页面显示布局，通过 DataBindingUtil.setContentView 方式加载
        // ActivityRecycleviewSimpleBinding 是 DataBinding 插件根据布局文件自动生成
        val binding = DataBindingUtil.setContentView<ActivityRecycleviewSimpleBinding>(
            this,R.layout.activity_recycleview_simple
        )

        // 绑定数据
        binding.viewModel = RecycleViewModel(this)
    }

}

通过 DataBinding 加载界面布局，然后绑定界面数据源。代码实现就完成了，运行一下看看效果：

可以发现整个实现过程中没有涉及 Adapter 和 ViewHolder，是不是比较省时省力。

3.3.5 数据更新

列表数据已经展示出来了，但却是静态数据，那么如何实现列表数据的动态更新呢，这就需要用到 DataBinding 提供的可观察者对象 Observable ，它是一个数据容器，里面存放的是我们需要的实际数据，当 Observable 中的数据发生变化时就会通知订阅它的观察者，Observable 提供了一个 List 的观察者容器 ObservableArrayList ，这里我们只需要将原来定义的 List 类型的 data 修改为 ObservableArrayList 即可，代码如下：

val data = ObservableArrayList<String>()

当我们对 data 中的数据进行更新的时候，就会自动刷新界面更新界面上显示的数据，下面为了演示在页面布局里添加两个按钮分别进行添加数据和删除数据的操作，如下：

<?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">

    <data>

        <variable
            name="viewModel"
            type="com.loongwind.ardf.demo.RecycleViewModel" />

    </data>

    <androidx.constraintlayout.widget.ConstraintLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent">

        <androidx.recyclerview.widget.RecyclerView
            android:layout_width="match_parent"
            android:layout_height="0dp"
            app:layout_constraintVertical_weight="1"
            app:layout_constraintTop_toTopOf="parent"
            app:layout_constraintBottom_toTopOf="@+id/add_item"
            app:layoutManager="androidx.recyclerview.widget.LinearLayoutManager"
            app:data="@{viewModel.data}"
            app:itemLayout="@{@layout/layout_item}"/>

        <Button
            android:id="@+id/add_item"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            app:layout_constraintBottom_toBottomOf="parent"
            app:layout_constraintLeft_toLeftOf="parent"
            android:layout_marginStart="20dp"
            android:layout_marginBottom="20dp"
            app:layout_constraintRight_toLeftOf="@id/del_item"
            android:text="添加item"
            android:onClick="@{()->viewModel.addItem()}"/>

        <Button
            android:id="@+id/del_item"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            app:layout_constraintTop_toTopOf="@id/add_item"
            app:layout_constraintRight_toRightOf="parent"
            app:layout_constraintLeft_toRightOf="@id/add_item"
            android:layout_marginEnd="20dp"
            android:text="删除item"
            android:onClick="@{()->viewModel.deleteItem()}"/>

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

按钮的点击事件也是通过 DataBinding 绑定到 ViewModel 的对应方法，也就是这里的 addItem()、deleteItem()，ViewModel 中代码如下：

class RecycleViewModel(var view: IView){

    ...

    fun addItem(){
        data.add("Item ${data.size}")
    }

    fun deleteItem(){
        data.removeAt(data.size - 1)
    }
}

演示代码简单实现了添加 item 和删除 item 的方法。运行一下看一下效果：

3.4 item 点击事件

item 的点击事件处理是列表开发中常见的事件处理，如点击列表 item 跳转到对应的详情页，ardf也对 item 的点击事件进行了封装，只需要在 xml 中通过 itemClick 为 RecyclerView 绑定点击事件即可，代码如下：

<androidx.recyclerview.widget.RecyclerView
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            app:layoutManager="androidx.recyclerview.widget.LinearLayoutManager"
            app:data="@{viewModel.data}"
            app:itemLayout="@{@layout/layout_item}"
            app:itemClick="@{(item,position)-> viewModel.onItemClick(item)}"/>

通过 DataBinding 将 item 的点击事件代理到 ViewModel 的 onItemClick 方法，onItemClick 方法是我们在 ViewModel 中自定义创建的，如下：

class RecycleViewModel(var view: IView){

    ...

    fun onItemClick(item:Any?){
        if(item is String){
            view.toast(item)
        }
    }
}

onItemClick 的参数是一个 Any? 类型，在布局 xml 中传入的是 item 的数据，所以需要判断数据类型与 item 的数据类型是否一致，再进行业务处理。

此处为了方便展示测试效果，通过自定义 IView 接口实现了 Toast 弹窗提示

运行效果如下：

3.5 Item 内部事件

对于复杂的业务可能需要在 item 内部进行事件处理，比如 item 上有可操作按钮、选择框等，ardf也对 item 内部事件的处理进行了封装，只需要在 xml 中通过 itemEventHandler 属性为 RecyclerView 绑定Item内部点击事件即可，如下：

<androidx.recyclerview.widget.RecyclerView
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            app:layoutManager="androidx.recyclerview.widget.LinearLayoutManager"
            app:data="@{viewModel.data}"
            app:itemLayout="@{@layout/layout_item}"
            app:itemEventHandler="@{viewModel}"/>

通过 itemEventHandler 将 ViewModel 传递到了 item 布局，在 item 布局里将 item 的内部事件代理到 ViewModel 内进行处理，item 布局代码如下：

<?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">

    <data>

        <variable
            name="item"
            type="String" />

        <variable
            name="handler"
            type="com.loongwind.ardf.demo.RecycleViewModel" />

    </data>

    <androidx.constraintlayout.widget.ConstraintLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content">

        <TextView
            android:id="@+id/text"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            app:layout_constraintTop_toTopOf="parent"
            app:layout_constraintLeft_toLeftOf="parent"
            app:layout_constraintRight_toRightOf="parent"
            android:gravity="center"
            android:padding="15dp"
            android:text="@{item}"/>

        <Button
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            app:layout_constraintTop_toTopOf="parent"
            app:layout_constraintBottom_toBottomOf="parent"
            app:layout_constraintRight_toRightOf="parent"
            android:text="删除"
            android:layout_marginRight="10dp"
            android:onClick="@{()->handler.eventDeleteItem(item)}"/>

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

item 布局里通过 handler接收传进来的 itemEventHandler对象，类型需跟 itemEventHandler 传递的类型一致，这里演示在 item 布局里添加一个删除按钮，再将删除按钮的点击事件代理到 ViewModel 的 eventDeleteItem方法，该方法也是在 ViewModel 中自定义创建的，如下：

class RecycleViewModel(var view: IView){

    ...

    fun eventDeleteItem(item:String){
        data.remove(item)
    }
}

该方法接收了一个 String 类型的 item 数据，实现从列表中移除该 item 数据，效果如下所示：

3.6 不同类型的 item 布局

RecyclerView 是支持不同类型的 item 布局的，ardf也通过提供 itemViewType属性的配置来实现不同类型 item 布局的展示。

itemViewType 属性需传入一个 ItemViewTypeCreator类型的对象，ItemViewTypeCreator是一个接口类型，定义如下：

interface ItemViewTypeCreator{
    /**
     * 通过 item 下标和数据返回布局类型
     * @param position item 下标
     * @param item item 数据
     * @return item 布局类型
     */
    fun getItemViewType(position: Int, item: Any?) : Int

    /**
     * 通过 item 布局类型返回布局资源 id
     * @param viewType item 数据类型
     * @return item 布局资源 id
     */
    fun getItemLayout(viewType: Int) : Int
}

在 ViewModel 创建一个 ItemViewTypeCreator 的对象实例，如下：

class MultiItemViewModel(var view: IView){
    // List 的 item 数据类型改为 Any
    val data = ObservableArrayList<Any>()

    // 定义多 item 布局类型的创建器
    val itemViewTypes = object : BaseBindingAdapter.ItemViewTypeCreator{
        override fun getItemViewType(position: Int, item: Any?): Int {
            // 通过 item 数据类型返回不同的布局类型
            return if(item is String){
                0
            }else{
                1
            }
        }

        override fun getItemLayout(viewType: Int): Int {
            // 根据不同的布局类型返回不同的布局资源 id
            return if(viewType == 0){
                R.layout.layout_item
            }else{
                R.layout.layout_item2
            }
        }

    }
    init {
        // 添加测试数据
        for (i in 0..10){
            // 双数添加字符串数据，单数添加 User 数据
            if(i % 2 == 0){
                data.add("Item $i")
            }else{
                data.add(User(name = "Name $i", img = "https://picsum.photos/200"))
            }

            println(data)
        }
    }
}

创建了一个 MultiItemViewModel 类用于演示实现不同类型 item 布局的处理，实例化一个 ItemViewTypeCreator 类的对象实现 item 类型和布局的返回。

将 data 类型修改为 ObservableArrayList<Any>用于存放不同类型的 item 数据。

User 的 item 布局《代码如下：

<?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">

    <data>
        <!-- DataBinding 接收 item 数据，数据类型为 User -->
        <variable
            name="item"
            type="com.loongwind.ardf.demo.User" />

    </data>

    <androidx.constraintlayout.widget.ConstraintLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:background="#3703A9F4">

        <!-- 用户头像，并绑定点击事件 -->
        <ImageView
            android:layout_width="32dp"
            android:layout_height="32dp"
            android:src="@mipmap/ic_launcher"
            app:layout_constraintLeft_toLeftOf="parent"
            app:layout_constraintTop_toTopOf="parent"
            app:layout_constraintBottom_toBottomOf="parent"
            android:layout_marginLeft="30dp"
            android:onClick="@{()->handler.omImgClick(item)}"/>

        <!-- 用户名称 -->
        <TextView
            android:id="@+id/text"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            app:layout_constraintTop_toTopOf="parent"
            app:layout_constraintLeft_toLeftOf="parent"
            app:layout_constraintRight_toRightOf="parent"
            android:gravity="center"
            android:padding="15dp"
            android:text="@{item.name}"/>

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

将接收的 item 数据类型换成 User。

最后在页面布局中的 RecyclerView 上配置 itemViewType 属性，如下：

<androidx.recyclerview.widget.RecyclerView
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            app:layoutManager="androidx.recyclerview.widget.LinearLayoutManager"
            app:data="@{viewModel.data}"
            app:itemViewType="@{viewModel.itemViewTypes}"/>

运行一下看一下效果:

4. 源码解析

上面介绍了 ardf 的使用方法，ardf的核心实现是封装了通用的 Adapter 和 ViewHolder，然后通过 DataBinding 的 @BindingAdapter扩展支持将 RecyclerView 的常用设置在 xml 里进行配置。

整体结构关系图如下：

从图上可以发现，ardf核心为以下三个模块：

  • ViewHolder 的封装：BindingViewHolder，实现 item 数据和内部事件的绑定
  • Adapter 的封装： BaseBindingAdapter、DefaultBindingAdapter，实现列表数据变化的监听、根据 item 布局创建 ViewHolder 并绑定事件
  • @BindingAdapter 扩展：setData方法，关联 RecyclerView 与 Adapter

接下来将从源码层面向大家介绍该封装的详细实现。

4.1 ViewHolder

创建一个 BindingViewHolder 类继承自 RecyclerView.ViewHolder ：

class BindingViewHolder<T, BINDING : ViewDataBinding>(val binding: BINDING) 
    : RecyclerView.ViewHolder(binding.root){

    fun bind(t: T?) {
        binding.setVariable(BR.item, t)
    }

    fun setItemEventHandler(handler:Any?){
        binding.setVariable(BR.handler, handler)
    }
}

该类有两个泛型，T为 item 的数据类型，BINDING为 item 布局生成的 ViewDataBinding 类。传入的参数 binding 即为 BINDING 类型，然后通过 binding.root获取布局的实际 View 将其传给 RecyclerView.ViewHolder。

BindingViewHolder 还对外提供了两个方法，bind和 setItemEventHandler方法。

bind 是用于绑定数据，即将 item 的数据和布局绑定起来，这里是通过 binding.setVariable(BR.item,t)将数据传递到布局里的 item 变量；

setItemEventHandler 是设置 item 内部事件处理的对象，绑定到布局的 handler 变量。

这里的 BR.item和 BR.handler是 DataBinding 根据布局里使用的变量自动生成的，所以为了生成这两个变量，建了一个空的布局文件，定义了这两个变量，如下：

<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android">

    <data>

        <variable
            name="item"
            type="Object" />
        <variable
            name="handler"
            type="Object" />

    </data>

</layout>

4.2 Adapter

创建好通用的 ViewHolder 以后，接下来就是封装通用的 Adapter，为了便于扩展先创建一个抽象的 BaseBindingAdapter定义如下：

abstract class BaseBindingAdapter<T:Any, BINDING : ViewDataBinding> :
    RecyclerView.Adapter<BindingViewHolder<T, BINDING>>() {
        ...
}

跟 BindingViewHolder 一样有两个泛型，Adapter 的 ViewHolder 泛型类型就是上面创建的 BindingViewHolder。

4.2.1 数据处理

类定义好后，接下来就是具体的实现，因为需要向 Adapter 中设置数据，所以需要定义一个 data 变量用于接收列表的数据源，并重写其 set 方法，代码如下：

/**
 * 列表数据
 */
var data: List<T>? = null
    @SuppressLint("NotifyDataSetChanged")
    set(data) {
        field = data
        // 判断如果是 ObservableList 类型，则为其添加 changeCallback 回调
        if (data is ObservableList<*>) {
            // 如果 listener 为空则创建 ObserverListChangeListener 对象，传入当前 Adapter
            if (listener == null) {
                listener = ObserverListChangeListener(this)
            }
            // 将已添加的 listener 移除，防止添加多个导致重复回调
            (data as ObservableList<T>).removeOnListChangedCallback(listener)

            // 设置 List 数据改变回调
            data.addOnListChangedCallback(listener)
        }
        // 刷新界面数据
        notifyDataSetChanged()
    }

data 用于接收设置的列表数据，重写了 set 方法，如果设置的数据类型是 ObservableList 则为其添加数据改变的回调。回调ObserverListChangeListener的代码如下：

class ObserverListChangeListener<T>(private val adapter:  RecyclerView.Adapter<*>) : ObservableList.OnListChangedCallback<ObservableList<T>>() {
    @SuppressLint("NotifyDataSetChanged")
    override fun onChanged(sender: ObservableList<T>) {
        adapter.notifyDataSetChanged()
    }

    override fun onItemRangeRemoved(sender: ObservableList<T>, positionStart: Int, itemCount: Int) {
        adapter.notifyItemRangeRemoved(positionStart, itemCount)
    }

    override fun onItemRangeMoved(sender: ObservableList<T>, fromPosition: Int, toPosition: Int, itemCount: Int) {
        adapter.notifyItemMoved(fromPosition, toPosition)
    }

    override fun onItemRangeInserted(sender: ObservableList<T>, itemCount: Int) {
        adapter.notifyItemRangeInserted(positionStart, itemCount)
    }

    override fun onItemRangeChanged(sender: ObservableList<T>, itemCount: Int) {
        adapter.notifyItemRangeChanged(positionStart, itemCount)
    }
}

构造参数传入了 RecyclerView.Adapter ，在每个数据变化的回调中调用 Adapter 的对应刷新数据的方法，实现数据变化自动刷新界面。

数据有了，getItemCount方法的实现就有了，同时为了方便根据 position 获取 item 的数据，这里也提取了一个 getItem方法，实现如下：

    fun getItem(position: Int): T? {
        return data?.getOrNull(position)
    }

        override fun getItemCount(): Int {
        return data?.size ?: 0
    }

4.2.2 创建布局

定义一个 layoutRes用于接收 item 布局的资源 id，如下：

    @get:LayoutRes
    abstract val layoutRes: Int

这里定义的是一个抽象 get 方法，需要子类去实现返回具体的 item 布局的资源 id。

定义 itemViewTypeCreator用于接收有多种 item 布局类型时的布局数据：

var itemViewTypeCreator: ItemViewTypeCreator? = null

实现 getItemViewType处理 item 布局类型：

   override fun getItemViewType(position: Int): Int {
        return itemViewTypeCreator?.getItemViewType(position, getItem(position))
            ?: super.getItemViewType(position)
    }

代码很好理解，如果 ItemViewTypeCreator 不为空则调用 getItemViewType 方法返回布局类型，如果为空则调用 super 方法，即默认的 item 布局类型。

然后实现 onCreateViewHolder方法，源码如下：

override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): BindingViewHolder<T, BINDING> {
    val layout = itemViewTypeCreator?.getItemLayout(viewType) ?: layoutRes
    val binding = DataBindingUtil.inflate<BINDING>(LayoutInflater.from(parent.context), layout, parent, false)
    val holder = BindingViewHolder<T, BINDING>(binding)
    bindClick(holder, binding)
    return holder
}

先判断 itemViewTypeCreator是否为空，不为空就调用 getItemLayout方法获取布局 id，为空则直接使用 layoutRes；获取到 item 布局的资源 id 后就可以通过 DataBindingUtil.inflate方法创建布局的 ViewDataBinding，再通过 binding 创建 ViewHolder 并返回。

4.2.3 绑定数据&事件

onCreateViewHolder 中创建完 holder 后还调用了一个 bindClick方法，用于绑定 item 的事件，bindClick的实现如下：

    protected fun bindClick(holder: BindingViewHolder<*, *>, binding: BINDING) {
        binding.root.setOnClickListener {
            val position = holder.layoutPosition
            itemClickListener?.onItemClick(getItem(position), position)
        }
    }

通过 binding.root获取 item 的 View 对象，然后对其设置点击事件，在事件的处理里调用 itemClickListener?.onItemClick，即布局里传入的 item 点击事件， itemClickListener的定义如下：

var itemClickListener: OnItemClickListener<T>? = null

interface OnItemClickListener<T> {
    fun onItemClick(t: T?, position: Int)
}

最后实现 onBindViewHolder方法进行数据绑定：

override fun onBindViewHolder(holder: BindingViewHolder<T, BINDING>, position: Int) {
    holder.bind(getItem(position))
    holder.setItemEventHandler(itemEventHandler)
}

先调用 holder.bind绑定数据，然后调用 holder.setItemEventHandler设置 item 内部事件的处理对象。

完整的 BaseBindingAdapter源码如下：

abstract class BaseBindingAdapter<T:Any, BINDING>>() {

    var itemClickListener: OnItemClickListener<T>? = null
    private var listener: ObserverListChangeListener<T>? = null
    var itemViewTypeCreator: ItemViewTypeCreator? = null
    var itemEventHandler : Any? = null

    var data: List<T>? = null
        @SuppressLint("NotifyDataSetChanged")
        set(data) {
            field = data
            //如果是ObservableList则为其添加changeCallback
            if (data is ObservableList<*>) {
                if (listener == null) {
                    listener = ObserverListChangeListener(this)
                }
                (data as ObservableList<T>).removeOnListChangedCallback(listener)
                data.addOnListChangedCallback(listener)
            }
            notifyDataSetChanged()
        }

    @get:LayoutRes
    abstract val layoutRes: Int

    fun getItem(position: Int): T? {
        return data?.getOrNull(position)
    }

    override fun onCreateViewHolder(parent: ViewGroup, BINDING> {
        val layout = itemViewTypeCreator?.getItemLayout(viewType) ?: layoutRes
        val binding = DataBindingUtil.inflate<BINDING>(LayoutInflater.from(parent.context), false)
        val holder = BindingViewHolder<T, BINDING>(binding)
        bindClick(holder, binding)
        return holder
    }

    override fun getItemViewType(position: Int): Int {
        return itemViewTypeCreator?.getItemViewType(position, getItem(position))
            ?: super.getItemViewType(position)
    }

    override fun onBindViewHolder(holder: BindingViewHolder<T, position: Int) {
        holder.bind(getItem(position))
        holder.setItemEventHandler(itemEventHandler)
    }

    override fun getItemCount(): Int {
        return data?.size ?: 0
    }

    interface OnItemClickListener<T> {
        fun onItemClick(t: T?, position: Int)
    }

    protected fun bindClick(holder: BindingViewHolder<*, position)
        }
    }

    interface ItemViewTypeCreator{
        fun getItemViewType(position: Int, item: Any?) : Int
        fun getItemLayout(viewType: Int) : Int
    }

}

4.2.4 通用 Adapter

BaseBindingAdapter类有一个 get 的 layoutRes 是抽象方法，需要子类传入一个 item 布局资源 id ，这里定义了一个通用也是默认的 DefaultBindingAdapter类：

class DefaultBindingAdapter(@param:LayoutRes @field:LayoutRes override val layoutRes: Int)
    : BaseBindingAdapter<Any, ViewDataBinding>()

只传入了一个参数，即 item 布局 id，将其作为 layoutRes 的 get 返回值。

4.3 @BindingAdapter

Adapter 准备好后，就可以通过 @BindingAdapter 将其与 RecyclerView 进行关联，实现在 xml 中配置数据源、布局和相关事件等数据。

DataBinding 实现在 xml 里绑定数据的本质是通过调用 View 对应属性的 set 方法来实现，如果 View 没有对应的 set 方法，就需要通过 @BindingAdapter 来扩展一个 set 方法来实现。这里为 RecyclerView 扩展了一个 setData 的方法，源码如下：

@BindingAdapter(value = ["data", "itemLayout", "itemClick","itemViewType", "itemEventHandler"], requireAll = false)
fun setData(
    recyclerView: RecyclerView,
    data: List<Any>?,
    @LayoutRes itemLayout: Int,
    listener: BaseBindingAdapter.OnItemClickListener<Any>?,
    itemViewTypeCreator: BaseBindingAdapter.ItemViewTypeCreator?,
    itemEventHandler: Any?
) {
    val adapter = recyclerView.adapter
    if (adapter == null) {
        val defaultBindingAdapter = DefaultBindingAdapter(itemLayout)
        defaultBindingAdapter.data = data
        defaultBindingAdapter.itemClickListener = listener
        defaultBindingAdapter.itemViewTypeCreator = itemViewTypeCreator
        defaultBindingAdapter.itemEventHandler = itemEventHandler
        recyclerView.adapter = defaultBindingAdapter
    } else if (adapter is BaseBindingAdapter<*, *>) {
        (adapter as BaseBindingAdapter<Any, ViewDataBinding>).data = data
        adapter.itemViewTypeCreator = itemViewTypeCreator
        adapter.itemClickListener = listener
        adapter.itemEventHandler = itemEventHandler
    }
}

要让 DataBinding 识别这个 set 方法需要在方法上加 @BindingAdapter 的注解，同时在注解中声明其在 xml 可配置的对应属性的名称，其传入的数据与该方法的参数除第一个参数以外一一对应，第一个参数则应用的 View 本身；注解上还有一个 requireAll参数，表示是否需要所有属性都在 xml 里配置了才能匹配使用该方法，这里设置的 false，即表示不用全都配置也能匹配到该方法。

具体实现首先获取 RecyclerView 当前的 adapter，如果当前 adapter 为空则创建一个 DefaultBindingAdapter ，然后设置列表数据、item 点击事件、多 item 布局类型的创建器、item 内部事件处理器，最后把 adapter 设置给 RecyclerView；如果 adapter 不为空，且类型为 BaseBindingAdapter则重新设置一遍 adapter 的对应数据 。

整个封装的实现逻辑和源码到这里就介绍完了，发现代码其实并不多，封装的实现也并不复杂，但是实际的使用效果却是非常不错的。

5. 最后

基于 DataBInding 对 RecyclerView 进行封装后，在进行列表功能的开发时无需再进行重复的 Adapter、ViewHolder 的样板代码编写，让开发者能更专注于列表功能业务本身的 item UI 布局的还原、数据逻辑的处理，从而提高开发效率，且大大的降低了布局与逻辑的耦合性，也便于在开发时进行对应的单元测试从而更好的提高开发质量。

原文地址：https://blog.csdn.net/weixin_61845324

版权声明：本文内容由互联网用户自发贡献，该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容， 请发送邮件至 dio@foxmail.com 举报，一经查实，本站将立刻删除。

相关推荐

更新Android SDK到3.0版本时，遇到Failed to rename directory E:androidtools to E:androidtempToolPackage.old01问题
更新Android SDK到3.0版本时，遇到Failed to rename directory E:\android\tools to E:\android\temp\ToolPackage.old01问题，导致无法更新，出现该问题的原因是由于3.0版本与较早的sdk版本之间文件结构有冲突，解决
Android 如何解决dialog弹出时无法捕捉Activity的back事件
Android 如何解决dialog弹出时无法捕捉Activity的back事件 在一些情况下，我们需要捕捉back键事件，然后在捕捉到的事件里写入我们需要进行的处理，通常可以采用下面三种办法捕捉到back事件： 1）重写onKeyDown或者onKeyUp方法 2）重写onBackPressed方
Android实现自定义带文字和图片的Button
Android实现自定义带文字和图片的Button 在Android开发中经常会需要用到带文字和图片的button，下面来讲解一下常用的实现办法。一.用系统自带的Button实现 最简单的一种办法就是利用系统自带的Button来实现，这种方式代码量最小。在Button的属性中有一个是drawable
Android中的"Unable to start activity ComponentInfo"或者"Unable to instantiate activity ComponentInfo"的错误
Android中的&quot;Unable to start activity ComponentInfo&quot;的错误 最近在做一款音乐播放器的时候，然后在调试的过程中发现一直报这个错误&quot;Unable to start activity ComponentInfo&quot;，从字面
Android 关于长按back键退出应用程序的实现
Android 关于长按back键退出应用程序的实现最近在做一个Android上的应用，碰到一个问题就是如何实现长按back键退出应用程序。在网上查找了很多资料，发现几乎没有这样的实现，大部分在处理时是双击back键来退出应用程序。参考了一下双击back键退出应用程序的代码，网上主流的一种方法是下面
android 可以精确到秒级的时间选择器
android自带的时间选择器只能精确到分，但是对于某些应用要求选择的时间精确到秒级，此时只有自定义去实现这样的时间选择器了。下面介绍一个可以精确到秒级的时间选择器。 先上效果图： 下面是工程目录： 这个控件我也是用的别人的，好像是一个老外写的，com.wheel中的WheelView是滑动控件的主
Android平台下利用zxing实现二维码开发
Android平台下利用zxing实现二维码开发 现在走在大街小巷都能看到二维码，而且最近由于项目需要，所以研究了下二维码开发的东西，开源的二维码扫描库主要有zxing和zbar，zbar在iPos平台上应用比较成熟，而在Android平台上主流还是用zxing库，因此这里主要讲述如何利用zxing
Android ListView的item背景色设置以及item点击无响应等相关问题
Android ListView的item背景色设置以及item点击无响应等相关问题 在Android开发中，listview控件是非常常用的控件，在大多数情况下，大家都会改掉listview的item默认的外观，下面讲解以下在使用listview时最常见的几个问题。1.如何改变item的背景色和按
如何向Android模拟器中导入含有中文名称的文件
如何向Android模拟器中导入含有中文名称的文件在进行Android开发的时候，如果需要向Android模拟器中导入文件进行测试，通过DDMS下手动导入或者在命令行下通过adb push命令是无法导入含有中文文件名的文件的。后来发现借用其他工具可以向模拟器中导入中文名称的文件，这个工具就是Ultr
Windows 下搭建Android开发环境
Windows 下搭建Android开发环境一．下载并安装JDK版本要求JDK1.6+，下载JDK成功后进行安装，安装好后进行环境变量的配置【我的电脑】-——&gt;【属性】——&gt;【高级】 ——&gt;【环境变量】——&gt;【系统变量】中点击【新建】：变量名：CLASSPATH变量值：……
如何利用PopupWindow实现弹出菜单并解决焦点获取以及与软键盘冲突问题
如何利用PopupWindow实现弹出菜单并解决焦点获取以及与软键盘冲突问题 在android中有时候可能要实现一个底部弹出菜单，此时可以考虑用PopupWindow来实现。下面就来介绍一下如何使用PopupWindow实现一个弹出窗。 主Activity代码：public void onCreat
解决Android中的ERROR: the user data image is used by another emulator. aborting的方法
解决Android中的ERROR: the user data image is used by another emulator. aborting的方法 今天调试代码的时候，突然出现这个错误，折腾了很久没有解决。最后在google上找到了大家给出的两种解决方案，下面给出这两种方法的链接博客：ht
ViewFlipper 简单应用
AdvserView.java package com.earen.viewflipper; import android.content.Context; import android.graphics.Bitmap; import android.graphics.BitmapFactory;
ImageView的scaleType属性 与 adjustViewBounds属性
ImageView的scaleType的属性有好几种，分别是matrix（默认）、center、centerCrop、centerInside、fitCenter、fitEnd、fitStart、fitXY。 |值|说明| |:--:|:--| |center|保持原图的大小，显示在ImageVie
在Android studio 3.2 版项目中使用cmake调用C/C++
文章浏览阅读8.8k次，点赞9次，收藏20次。本文操作环境:win10/Android studio 3.21.环境配置 在SDK Tools里选择 CMAKE/LLDB/NDK点击OK 安装这些插件. 2.创建CMakeLists.txt文件 在Project 目录下,右键app，点击新建File文件,命名为CMakeLists.txt点击OK，创建完毕! 3.配置文件 在CMa..._link c++ project with gradle
Android studio跳转界面
文章浏览阅读1.2w次，点赞15次，收藏69次。实现目的：由mainActivity界面跳转到otherActivity界面1.写好两个layout文件，activity_main.xml和otherxml.xmlactivity_main.xml&lt;?xml version="1.0" encoding="utf-8"?&gt;&lt;RelativeLayout ="http://schemas..._android studio 界面跳转
Android全局代理软件ProxyDroid和TransProxy源码分享
文章浏览阅读3.8w次。前言：最近在找Android上的全局代理软件来用，然后发现了这两款神作，都是外国的软件，而且都是开源的软件，因此把源码下载了下来，给有需要研究代理这方面的童鞋看看。不得不说，国外的开源精神十分浓，大家相互使用当前基础的开源软件，然后组合成一个更大更强的大开源软件。好吧，废话不多说，下面简单介绍一下这两款开源项目。一、ProxyDroid：ProxyDroid功能比较强大，用到的技术也比较多，源码也_proxydroid
Error:(23, 25) 错误: 程序包R不存在
文章浏览阅读2.5w次，点赞17次，收藏6次。创建项目后，运行项目时Gradle Build 窗口却显示错误：程序包R不存在通常情况下是不会出现这个错误的。我是怎么遇到这个错误的呢？第一次创建项目，company Domain我使用的是：aven.com，但是创建过程在卡在了Building 'Calculator' Gradle Project info这个过程中，于是我选择了“Cancel”第二次创建项目，我还是使用相同的项目名称和项目路_r不存在
教你在Android手机上使用全局代理！
文章浏览阅读8.9w次，点赞4次，收藏43次。前言：在Android上使用系统自带的代理，限制灰常大，仅支持系统自带的浏览器。这样像QQ、飞信、微博等这些单独的App都不能使用系统的代理。如何让所有软件都能正常代理呢？ProxyDroid这个软件能帮你解决！使用方法及步骤如下：一、推荐从Google Play下载ProxyDroid，目前最新版本是v2.6.6。二、对ProxyDroid进行配置（基本配置：） （1） Auto S_proxydroid使用教程
【Android 开发入门】Android设备监视器之调试工具DDMS使用初探
文章浏览阅读1.1w次，点赞4次，收藏17次。Android Studio提供了一个很实用的工具Android设备监视器(Android device monitor)，该监视器中最常用的一个工具就是DDMS（Dalvik Debug Monitor Service），是 Android 开发环境中的Dalvik虚拟机调试监控服务。可以进行的操作有：为测试设备截屏，查看特定进程中正在运行的线程以及堆栈信息、Logcat、广播状态信息、模拟电话_安卓摄像头调试工具
pythonJavaScriptjavaHTMLPHPreactjsC#AndroidCSSNode.jssqlrpython-3.xMysqLjQueryc++pandasFlutterangularIOSdjangolinuxswifttypescript路由器JSON路由器设置无线路由器h3c华三华三路由器设置华三路由器电脑软件教程arraysdocker软件图文教程Cvue.jslaravelspring-boot