如何在项目中封装 Kotlin + Jetpack Databinding

如何在项目中封装 Kotlin + Jetpack Databinding

  • 如果评论区没有及时回复,欢迎来公众号:ByteCode 咨询
  • 公众号:ByteCode。致力于分享最新技术原创文章,涉及 Kotlin、Jetpack、算法、译文、系统源码相关的文章

在之前的文章 0xA05 Android 10 源码分析:Dialog 加载绘制流程以及在 Kotlin、DataBinding 中的使用 分析了 Dialog 加载绘制流程、设计模式,以及基于 DataBinding 封装的 DataBindingDialog 的基础库 JDataBinding。

这篇文章主要来分析如何基于 DataBinding 封装 DataBindingActivityDataBindingFragmentDataBindingDialogDataBindingListAdapter 等等,成员陆续增加中,代码已经上传到 GitHub 欢迎前去查看仓库 JDataBinding

JDataBinding 源码地址:https://github.com/hi-dhl/JDataBinding

什么是 DataBinding?

DataBinding 是 Google 在 Jetpack 中推出的一个数据绑定的支持库,利用该库可以实现在页面组件中直接绑定应用程序的数据源。

利用 Kotlin 中的 inlinereifiedDSL 等等语法, 结合着 DataBinding,可以设计出更加简洁并利于维护的代码,首先我们先来看一下 DataBinding 在 ListAdapter 中的使用。

DataBindingListAdapter

DataBindingListAdapter 是基于 ListAdapter 封装的,使用更少的代码快速实现 RecyclerView adapter 和 ViewHolder。

什么是 ListAdapter?

ListAdapter 是 Google 推出的一个新的类库,相比传统的 Adapter,它能够用较少的代码实现更多的 RecylerView 的动画,并且可以自动存储之前的 list,ListAdapter 还加入了 DiffUtil 的工具类,只有当 items 变化的时候进行刷新,而不用刷新整个 list,大大提高 RecyclerView 的性能。

什么是 DiffUtil?

DiffUtil 主要在后台计算 list 是否相同,然后回到回主线程刷新数据,主要使用了 Myers Diff Algorithm 算法, 而我们日常使用的 git diff 就用到了该算法。

好了介绍完基础概念之后,来看一下 DataBindingListAdapter 是如何使用的。

Step1: 继承 BaseViewHolder

创建一个自定义的 ViewHolder 类,继承 BaseViewHolder ,通过 viewHolderBinding 可以快速实现 DataBinding 的绑定。

class TestViewHolder(view: View) : BaseViewHolder<Model>(view) {

val binding: RecycieItemTestBinding by viewHolderBinding(view)

override fun bindData(data: Model) {
binding.apply {
model = data
executePendingBindings()
}
}

}

Step2: 继承 DataBindingListAdapter

实现带头部和尾部的 Adapter,创建自定义的 Adapter,继承 DataBindingListAdapter

class TestAdapter : DataBindingListAdapter<Model>(Model.CALLBACK) {

override fun viewHolder(layout: Int, view: View): DataBindingViewHolder<Model> = when (layout) {
R.layout.recycie_item_header -> HeaderViewHolder(view)
else -> TestViewHolder(view)
}

override fun layout(position: Int): Int = when (position) {
0 -> R.layout.recycie_item_header
getItemCount() - 1 -> R.layout.recycie_item_footer
else -> R.layout.recycie_item_test
}

override fun getItemCount(): Int = super.getItemCount() + 2
}

构造方法需要传入了 Model.CALLBACKModel.CALLBACK 实现了 DiffUtil.ItemCallback,用于计算 list 的两个非空 item 的不同。需要重写两个抽象方法 areItemsTheSameareContentsTheSame

val CALLBACK: DiffUtil.ItemCallback<Model> = object : DiffUtil.ItemCallback<Model>() {
// 判断两个Objects 是否代表同一个item对象, 一般使用Bean的id比较
override fun areItemsTheSame(oldItem: Model, newItem: Model): Boolean =
oldItem.id == newItem.id

// 判断两个Objects 是否有相同的内容。
override fun areContentsTheSame(oldItem: Model, newItem: Model): Boolean = true
}

Step3: 绑定 RecyclerView 和 Adapter

<data>

<variable
name="viewModel"
type="com.hi.dhl.jdatabinding.demo.ui.MainViewModel" />

<variable
name="testAdapter"
type="com.hi.dhl.jdatabinding.demo.ui.TestAdapter" />
</data>

<androidx.recyclerview.widget.RecyclerView
android:layout_width="match_parent"
android:layout_height="match_parent"
app:adapter="@{testAdapter}"
app:adapterList="@{viewModel.mLiveData}"
app:layoutManager="androidx.recyclerview.widget.LinearLayoutManager" />

这里用到了 DataBinding 的自定义数据绑定部分,具体实现可以参考仓库 JDataBinding 中的 fragment_test.xml 文件。

DataBindingDialog

在 Kotlin 中应该尽量避免使用构建者模式,使用 Kotlin 的具名可选参数构造类,实现构建者模式,代码更加简洁。

在 “Effective Java” 书中介绍构建者模式时,是这样子描述它的:本质上 builder 模式模拟了具名的可选参数,就像 Ada和 Python中的一样。

幸运的是,Kotlin 是一门拥有具名可选参数的变成语言,DataBindingDialog 通过使用 Kotlin 的具名可选参数构造类,实现了 Dailog 构建者模式,用 DataBinding 进行二次封装,加上 DataBinding 数据绑定的特性,使 Dialog 变得更加简洁、易用。

Step1: 继承 DataBindingDialog

class AppDialog(
context: Context,
val title: String? = null,
val message: String? = null,
val yes: AppDialog.() -> Unit
) : DataBindingDialog(context, R.style.AppDialog) {
private val mBinding: DialogAppBinding by binding(R.layout.dialog_app)

init {
requireNotNull(message) { "message must be not null" }
}

override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
requestWindowFeature(Window.FEATURE_NO_TITLE)

mBinding.apply {
setContentView(root)
display.text = message
btnNo.setOnClickListener { dismiss() }
btnYes.setOnClickListener { yes() }
}

}
}

Step2: 简洁的调用方式

AppDialog(
context = this@MainActivity,
message = msg,
yes = {
// do something
}).show()

DataBindingActivity

Kotlin 中的函数和构造器都支持具名可选参数,在使用上更加灵活,在 DataBindingActivity 中使用 Kotlin 的 inline、reified 强大的特性,将类型参数实化,初始化 View 更加简洁。

继承 DataBindingActivity

class MainActivity : DataBindingActivity() {
private val mBinding: ActivityMainBinding by binding(R.layout.activity_main)

override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
mBinding.apply {
dialog.setOnClickListener {
val msg = getString(R.string.dialog_msg)
AppDialog(
context = this@MainActivity,
message = msg,
yes = {
Toast.makeText(this@MainActivity, msg, Toast.LENGTH_SHORT).show()
}).show()
}
}
}
}

DataBindingFragment

在 Fragment 当中如何使用 Kotlin 的 inline、reified 初始化 View,可以查看 DataBindingFragment

继承自 DataBindingFragment

class FragmentTest : DataBindingFragment() {
val testViewModel: MainViewModel by viewModel()

override fun onCreateView(
inflater: LayoutInflater,
container: ViewGroup?,
savedInstanceState: Bundle?
): View? {

return binding<FragmentTestBinding>(
inflater,
R.layout.fragment_test, container
).apply {
viewModel = testViewModel
testAdapter = TestAdapter()
lifecycleOwner = this@FragmentTest
}.root
}
}

JDataBinding 是基于 DataBinding 封装的 DataBindingActivityDataBindingFragmentDataBindingDialogDataBindingListAdapter 基础库。

文章中相关示例,已经上传到 GitHub 欢迎前去查看仓库 JDataBinding

参考文献

https://github.com/..BaseRecyclerViewAdapter

致力于分享一系列 Android 系统源码、逆向分析、算法、翻译、Jetpack 源码相关的文章,在技术的道路上一起前进

Android10 源码分析

正在写一系列的 Android 10 源码分析的文章,了解系统源码,不仅有助于分析问题,在面试过程中,对我们也是非常有帮助的,如果你同我一样喜欢研究 Android 源码,可以关注我 GitHub 上的 Android10-Source-Analysis

算法题库的归纳和总结

由于 LeetCode 的题库庞大,每个分类都能筛选出数百道题,由于每个人的精力有限,不可能刷完所有题目,因此我按照经典类型题目去分类、和题目的难易程度去排序。

  • 数据结构: 数组、栈、队列、字符串、链表、树……
  • 算法: 查找算法、搜索算法、位运算、排序、数学、……

每道题目都会用 Java 和 kotlin 去实现,并且每道题目都有解题思路,如果你同我一样喜欢算法、LeetCode,可以关注我 GitHub 上的 LeetCode 题解:Leetcode-Solutions-with-Java-And-Kotlin

精选国外的技术文章

目前正在整理和翻译一系列精选国外的技术文章,不仅仅是翻译,很多优秀的英文技术文章提供了很好思路和方法,每篇文章都会有译者思考部分,对原文的更加深入的解读,可以关注我 GitHub 上的 Technical-Article-Translation

评论