孟老闆 ListAdapter封裝, 告別Adapter代碼 (上)

ListAdapter封裝 (上) – SimpleAdapter 

前言:

上一篇文章已經講解 ListAdapter 的基本使用;  這次 我們不再關心 實體類型、Item事件回調,  編寫統一 DiffCallback,  布局ID傳入. 

 

使用:

1. 首先新建 BaseItem: 列表實體都會實現此接口.  它是 BaseAdapter 的默認實體類型

interface BaseItem {
    /**
     *  條目更新標記, 用於 DiffUtil areContentsTheSame
     */
    var hasChanged: Boolean

    /**
     *  Adapter 中的 ItemType.
     * 單類型布局可以不用關心 該返回值
     * 多類型布局中;  需直接返回布局Id;  例如: R.layout.item_test
     */
    fun getMItemType(): Int = 0
}

 

2. 再創建實體類,  實現 BaseItem 接口;  除了  hasChanged,  只有一個 title 參數;

class TestEntity(
    var title: String? = null,
    override var hasChanged: Boolean = false
) : BaseItem

 

3.編寫通用的 DiffCallback;  實體類型就用 BaseItem 

areItemsTheSame(): 我們選用比較內存地址的方式; 

areContentsTheSame(): 我們選擇狀態標記方式;

class DiffCallback: DiffUtil.ItemCallback<BaseItem>() {
    /**
     * 比較兩個條目對象  是否為同一個Item
     */
    override fun areItemsTheSame(oldItem: BaseItem, newItem: BaseItem): Boolean {
        return oldItem === newItem
    }

    /**
     * 再確定為同一條目的情況下;  再去比較 item 的內容是否發生變化;
     * 我們使用 狀態標識方式判斷;
     * @return true: 代表無變化;  false: 有變化;
     */
    override fun areContentsTheSame(oldItem: BaseItem, newItem: BaseItem): Boolean {
        return !oldItem.hasChanged
    }
}

 

4.接下來是 ViewHolder:  用於 item 綁定數據,及緩存控件.   我們加入事件處理 handler; 以及重置狀態標記;

open class NewViewHolder(val binding: ViewDataBinding, private val handler: BaseHandler?) : RecyclerView.ViewHolder(binding.root){
    open fun bind(item: BaseItem?) {
        //重置 狀態標記
        item?.hasChanged = false
        binding.setVariable(BR.item, item)
        binding.setVariable(BR.handler, handler)
        binding.executePendingBindings()
    }
}

 

5. Handler : MVVM 模式中 Item事件響應處理類;   

基類: BaseHandler   它幾乎只出現在 Adapter相關基類中,省的我們再寫泛型;   要使用還得用它的子類

子類: Handler  提供具體實體泛型.  供布局文件使用

/**
 * item 事件響應基類, 這類什麼都不用寫
 */
open class BaseHandler


/**
 * item 事件響應基類, 需提供具體的實體類泛型;
 */
abstract class Handler<T: BaseItem> : BaseHandler() {
    abstract fun onClick(view: View, info: T)
}

 

6.下面是重頭戲了:  BaseAdapter

重頭戲?但它卻如此簡單  [捂臉] (自帶轉義);   只需要傳入 BaseHandler 對象;  並重寫 onBindViewHolder 即可;  

我還重寫了 submitList();  因為ListAdapter 提交數據時,會判斷前後數據集合是否為同一內存地址;  我們讓它必定以新數據集對象傳入; (雖然個人感覺這樣不對, 但博主還就踩上這坑了 [機智])

abstract class BaseAdapter(
    protected val handler: BaseHandler? = null) :
    ListAdapter<BaseItem, NewViewHolder>(DiffCallback()) {

    override fun onBindViewHolder(holder: NewViewHolder, position: Int) {
        holder.bind(getItem(position))
    }

    /**
     * 重寫 提交數據方法, 讓它必定以新數據集合對象傳入
     */
    override fun submitList(list: MutableList<out BaseItem>?) {
        val newData = mutableListOf<BaseItem>()
        if (list != null) {
            newData.addAll(list)
        }
        super.submitList(newData)
    }
}

 

7. 重頭戲中的重頭來了 SimpleAdapter: 

好吧, 它更簡單.  繼承 BaseAdapter 並傳入 layoutId, 再重寫 onCreateViewHolder 即可;

open class SimpleAdapter(
    /**
     * 布局id;
     */
    private val layout: Int,
    handler: BaseHandler? = null
) :
    BaseAdapter(handler) {

    override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): NewViewHolder {
        return NewViewHolder(
            DataBindingUtil.inflate(
                LayoutInflater.from(parent.context), layout, parent, false
            ), handler
        )
    }
}

 

8. 好了封裝完事.  接下來我們要開始用了!  使用也非常簡單

//只需要傳入  布局id 及 事件響應 Handler
mAdapter = SimpleAdapter(R.layout.item_test_mvvm, object : Handler<TestEntity>(){
    override fun onClick(view: View, info: TestEntity) {
        Toast.makeText(mActivity, "點了條目", Toast.LENGTH_SHORT).show()
    }
})
mDataBind.rvRecycle.let {
    it.layoutManager = LinearLayoutManager(mActivity)
    it.adapter = mAdapter
}
val data = mutableListOf(TestEntity("第一條"), TestEntity("第一條"), TestEntity("第一條"), TestEntity("第一條"), TestEntity("第一條"))
mAdapter.submitList(data)

 

9. 好吧,再貼出我的 布局文件: 

<layout xmlns:android="//schemas.android.com/apk/res/android">

    <data>
        <variable
            name="item"
            type="com.example.kotlinmvpframe.network.entity.TestEntity" />
        <variable
            name="handler"
            type="com.example.kotlinmvpframe.test.testtwo.Handler" />
    </data>

    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:orientation="horizontal"
        android:onClick="@{(view) -> handler.onClick(view, item)}"
        android:padding="20dp">
        <TextView
            android:id="@+id/btn2"
            style="@style/tv_base_16_dark"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="@{item.title}" />
    </LinearLayout>
</layout>

 

好的! over

下一篇再講  多條目類型, 嵌套RecycleView, 封裝頭尾 等等! 敬請期待

回到頂部