Generic Recycler View أو كيف لا تكتب كود boilerplate

كلنا نكتب طلبات ولدينا جميعًا قوائم. والحل الأكثر وضوحا هو RecyclerView. التنفيذ نفسه ليس معقدًا ، ولم يعد كتابة دليل على RecyclerView ذا صلة. ولكن هناك شيء واحد. في كل مرة نحتاج فيها إلى قائمة ، نقوم بإنشاء فصل ، ونصف أساليب القالب فيه ، وننشئ فئات قوالب. عندما يكون لدينا 2-3 قوائم ، فلا حرج في ذلك. ولكن عندما يكون هناك 10 منهم أو أكثر ، فأنت لا تريد القيام بذلك بعد الآن.

واجهت مشكلة ، بدأت في البحث. العثور على تطبيق واحد مثير جدا للاهتمام على Kotlin. أعجبتني ، لكنها كانت تفتقر إلى بعض العناصر. بعد أن أمضيت بضع ساعات ، تمكنت من وضع اللمسات الأخيرة عليه ، والآن أصبح تنفيذ المحول يستغرق عدة خطوط. وهنا أريد مشاركتها معك.

أول شيء يتعين علينا القيام به هو إنشاء محول.

abstract class GenericAdapter<T> : RecyclerView.Adapter<RecyclerView.ViewHolder> { private var itemList = mutableListOf<T>() constructor() override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): RecyclerView.ViewHolder { return getViewHolder( LayoutInflater.from(parent.context) .inflate(viewType, parent, false) , viewType ) } override fun onBindViewHolder(holder: RecyclerView.ViewHolder, position: Int) { (holder as Binder<T>).bind(itemList[position], itemClickListener) } override fun getItemCount(): Int = itemList.size override fun getItemViewType(position: Int): Int = getLayoutId(position, itemList[position]) fun update(items: List<T>) { itemList = items.toMutableList() notifyDataSetChanged() } protected abstract fun getLayoutId(position: Int, obj: T): Int protected open fun getViewHolder(view: View, viewType: Int): RecyclerView.ViewHolder { return ViewHolderFactory.create(view, viewType) } internal interface Binder<T> { fun bind(data: T) } } 

ما الذي يحدث هنا؟ نقوم بإنشاء محول ذو معلمات وإعادة تعريف أساليب القالب الأساسية فيه. ننشئ الواجهة واجهة Binder ذات معلمات ، والتي سيتعين على ViewHolder تنفيذها. في طريقة getLayoutId () المجردة ، سنقوم بتعيين التنسيق لدينا.

بعد أن ننشئ مصنعًا لـ ViewHolder الخاص بنا.

 object ViewHolderFactory { fun create(view: View, viewType: Int): RecyclerView.ViewHolder { return when (viewType) { R.layout.item_data -> DataViewHolder(view) R.layout.item_other_data -> OtherDataViewHolder(view) else -> throw Exception("Wrong view type") } } class DataViewHolder(itemView: View) : RecyclerView.ViewHolder(itemView), GenericAdapter.Binder<Data> { override fun bind(data: Data) { itemView.apply { dateTextView.text = data.dateTitle } } class OtherDataViewHolder(itemView: View) : RecyclerView.ViewHolder(itemView), GenericAdapter.Binder<OtherData> { override fun bind(data: OtherData) { itemView.apply { dateTextView.text = data.dateTitle } } } 

وهذه هي الطريقة التي سيبدو بها تنفيذ هذا المحول في الجزء.

 private lateinit var adapter GenericAdapter<Data> protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); adapter = dataAdapter } private val dataAdapter = object : GenericAdapter<Data>() { override fun getLayoutId(position: Int, obj: Data): Int = R.layout.item_data } 

كل شيء رائع ومريح وسريع. في هذا النموذج تقريبًا ، وجدت هذا التطبيق. ولكن بعد ذلك فكرت ، ماذا عن العناصر القابلة للنقر. وهنا قراري.

أولاً ، قم بإنشاء واجهة

 interface OnItemClickListener<T> { fun onClickItem(data: T) } 

ونقلها إلى واجهة الموثق لدينا

 internal interface Binder<T> { fun bind(data: T, listener: OnItemClickListener<T>?) } 

وفي المحول ، قم بإنشاء مُنشئ إضافي:

  private var itemClickListener: OnItemClickListener<T>? = null constructor(listener: OnItemClickListener<T>) { itemClickListener = listener } class DataViewHolder(itemView: View) : RecyclerView.ViewHolder(itemView), GenericAdapter.Binder<Data> { override fun bind(data: Data, listener: OnItemClickListener<Data>?) { itemView.apply { dateTextView.text = data.dateTitle setOnClickListener { listener?.onClickItem(data) } } } 

ما لدينا في النهاية ، محول يتم إنشاؤه في 3 أسطر وواجهة عالمية لجميع أنواع العناصر. إذا لم نكن بحاجة إلى معالجة النقرات ، فإننا ببساطة لا ننقل المستمع إلى المُنشئ. لكن هذا ليس كل شيء.

ماذا لو أردنا ربط DiffUtils.Callback بمحولنا.

 class GenericDiffUtil<T>( private val oldItems: List<T>, private val newItems: List<T>, private val itemDiff: GenericItemDiff<T> ) : DiffUtil.Callback() { override fun getOldListSize() = oldItems.size override fun getNewListSize() = newItems.size override fun areItemsTheSame(oldItemPosition: Int, newItemPosition: Int) = itemDiff.isSame(oldItems, newItems, oldItemPosition, newItemPosition) override fun areContentsTheSame(oldItemPosition: Int, newItemPosition: Int) = itemDiff.isSameContent(oldItems, newItems, oldItemPosition, newItemPosition) } interface GenericItemDiff<T> { fun isSame( oldItems: List<T>, newItems: List<T>, oldItemPosition: Int, newItemPosition: Int ): Boolean fun isSameContent( oldItems: List<T>, newItems: List<T>, oldItemPosition: Int, newItemPosition: Int ): Boolean } 

هذا هو ما تبدو عليه الفئة الأساسية لـ DiffUtils. إضافة طريقة إلى محول لدينا

 private var diffUtil: GenericItemDiff<T>? = null fun setDiffUtilCallback(diffUtilImpl: GenericItemDiff<T>) { diffUtil = diffUtilImpl } 

وتعديل طفيف تحديث طريقة المحول ()

  fun update(items: List<T>) { if (diffUtil != null) { val result = DiffUtil.calculateDiff(GenericDiffUtil(itemList, items, diffUtil!!)) itemList.clear() itemList.addAll(items) result.dispatchUpdatesTo(this) } else { itemList = items.toMutableList() notifyDataSetChanged() } } 

ولذا فإننا ننفذ DiffUtils لدينا

 adapter.setDiffUtilCallback(dataDiffUtil) private val dataDiffUtil = object : GenericItemDiff<Data> { override fun isSame( oldItems: List<Data>, newItems: List<Data>, oldItemPosition: Int, newItemPosition: Int ): Boolean { val oldData = oldItems[oldItemPosition] val newData = newItems[newItemPosition] return oldData.id == newData.id } override fun isSameContent( oldItems: List<Data>, newItems: List<Data>, oldItemPosition: Int, newItemPosition: Int ): Boolean { val oldData = oldItems[oldItemPosition] val newData = newItems[newItemPosition] return oldData.name == newData.name && oldData.content == newData.content } 

نتيجة لذلك ، لدينا تطبيق بسيط ومرن إلى حد ما لرمز القالب. تنفيذ مريح للمحولات مع ViewHolders متعددة. المنطق المركزي في مكان واحد.

هنا يمكنك رؤية الكود المصدري .

وهنا يمكنك أن ترى النسخة الأصلية .