Skip to content

Latest commit

 

History

History
216 lines (173 loc) · 8.93 KB

README.md

File metadata and controls

216 lines (173 loc) · 8.93 KB
Raw

代码非常简单，基于dataBinding

概览

本项目主要做了RecyclerView adapter、ListView adapter、ViewPager adapter fragment的封装，旨在减少大量模板代码。

也加了和这些相关连带问题的解决方法：adapter套RecyclerView回调繁琐、动态fragment刷新白屏、ViewPager和ViewPager2高度不能wrap等问题的解决

背景介绍

Adapter属于View层，Activity也是View层，在当前各种新框架下两个几乎没有什么代码，然而它们之间交互起来特别繁琐，如果我们直接将Adapter合并到Activity里，会产生什么意想不到的结果呢？

详细介绍

一个简单的listAdapter只需要如下一行（没看错，总共就一行），基于ViewBinding

class MainActivity : AppCompatActivity() {
    //lazyNone就是lazy(LazyThreadSafetyMode.NONE, initializer)的拓展
    private val listAdapter by lazyNone {
        createListVbAdapter<AdapterMainListBinding, String> { holder, vb, bean -> }
    }
}

点击事件什么的都不需要额外操作，没有回调也不需要额外传参，直接在Adapter写就行了

class MainActivity : AppCompatActivity() {
    private val listAdapter by lazyNone {
        createListVbAdapter<AdapterMainListBinding, String> { holder, vb, bean ->
            holder.itemView.setBackgroundColor(if (bean.contains("10")) 0xff999999.toInt() else 0xffffffff.toInt())
            vb.tvText.text = bean
            vb.btButton.setOnFastClickListener {
                toast("点击了Button")
            }
            holder.setOnFastClickListener {
                toast("点击item了${holder.listPosition}")
            }
        }.apply {
            //自带header、footer
            headerView = AppCompatTextView(this@MainActivity).apply {
                text = "这是header"
            }
        }
    }
}

更精简的条目写法

只有2个方法：addMultipleItem、addDefaultMultipleItem

addMultipleItem的isThisTypeCallback返回一个布尔值表示是否是当前条目，不需要额外其他逻辑

小提示：对于addMultipleItem这种多参数idea无法自动快速提示出来，可以使用“Ctrl+空格”来主动弹出。但是由于Windows占用了这个快捷键，请打开“设置> Keymap>Main Menu>Code>Code Completion>Basic”来重新设置，比如：“Ctrl+;”、“Ctrl+,”

    private val multiAdapter by lazyNone {
        createMultiAdapter<TestBean>().apply {
            addMultipleItem<AdapterMainMultiple0Binding>(isThisTypeCallback = { listPosition, _ -> listPosition % 3 == 0 }) { holder, vb, bean ->
                vb.tvText.setTextColor(0xff00ff00.toInt())
                vb.tvText.text = "多条目0：${bean.text}"
                holder.setOnFastClickListener {
                    toast("点击item了${holder.listPosition}")
                }
            }
            addMultipleItem<AdapterMainMultiple1Binding>(isThisTypeCallback = { listPosition, _ -> listPosition % 3 == 1 }) { holder, vb, bean ->
                vb.tvText2.text = "多条目1：${bean.text}"
            }
            //多条目兜底，上面判断完后的剩余情况防止出错，如：后端新增了新的数据类型
            addDefaultMultipleItem<AdapterMainMultipleDefBinding>()

            headerView = AppCompatTextView(this@MainActivity).apply { text = "这是header" }
            footerView = AppCompatTextView(this@MainActivity).apply { text = "这是footer" }
        }
    }

嵌套？直接正常写就行了

注意：嵌套效率问题暂且不在当前讨论范围内

    private val nesAdapter by lazyNone {
        createListVbAdapter<AdapterMainNesBinding, TestBean> { holder, vb, bean ->
            vb.tvNesText.text = "这是嵌套外层：${bean.text},${holder.listPosition},${holder.adapterLayoutPosition}"
            val itemAdapter = vb.rvItemList.getAdapterOrCreate {
                createListVbAdapter<AdapterMainNesItemBinding, String> { holder, vb, bean ->
                    vb.tvItem.text = "这是内层$bean,${holder.listPosition},${holder.adapterLayoutPosition}"
                }.apply {
                    headerView = AppCompatTextView(this@MainActivity).apply {
                        text = "这是内层header"
                        setOnFastClickListener {
                            toast("你点击了内层header")
                        }
                    }
                    footerView = AppCompatTextView(this@MainActivity).apply { text = "这是内层footer" }
                    vb.rvItemList.setGridLayoutManagerSpanSizeLookup {
                        when (it) {
                            0, (itemCount - 1) -> 2
                            else -> 1
                        }
                    }
                }
            }
            itemAdapter.notifyDataSetChanged(bean.itemTextList)
        }.apply {
            headerView = AppCompatTextView(this@MainActivity).apply {
                text = "这是外层header"
                setTextColor(0xff00ff00.toInt())
            }
        }
    }

当然也可以使用原始继承方式（不推荐）

不推荐这么写，因为需要来回处理页面交互

class MyAdapter: BaseListAdapter<AdapterMainListBinding, String>(/*可选传list*/) {
    override fun onBindListViewHolder(holder: BaseViewHolder<AdapterMainListBinding>, bean: String){
        //bind
    }

//        按混淆配置好，这里就不需要重写
//        override fun onCreateListViewHolder(parent: ViewGroup): BaseViewHolder<AdapterMainListBinding> =
//            BaseViewHolder(ViewBindingHelper.getViewBindingInstanceByClass<AdapterMainListBinding>(parent.layoutInflater, parent))
}

ViewPager的Fragment更简单

mVp.setAdapter(new BaseFragmentPagerAdapter(getSupportFragmentManager(), mFrags));
//或
mVp.setAdapter(new BaseFragmentPagerAdapter(getSupportFragmentManager(), frag1,frag2...));
//动态修改frag
mAdapter = new BaseFragmentStatePagerAdapter(getSupportFragmentManager(), mFrags);
mVp.setAdapter(mAdapter);
...
mAdapter.getFragments().add(xxx);//由于内部有新的list，所以并不能用自己的mFrags
mAdapter.getFragments().remove(yyy);
mAdapter.notifyDataSetChanged();
//解决动态修改刷新白屏的问题
BaseFragmentNotifyAdapter adapter = new BaseFragmentNotifyAdapter(getSupportFragmentManager(), mFrags);
mVp.setAdapter(adapter);
...
adapter.notifyAllItem(1);//保留展示的frag这样就不会白屏了，想要刷新这个frag当然需要自己frag内部刷新了，详见app下的示例

多条目太复杂，无法满足？

当然还有适用于各种复杂样式的adapter容器（如：聊天列表，首页、今日头条的列表等）：

本项目已内置为kotlin版（待后续继续简化），直接使用即可： 一个通过add其他adapter的超级容器，无论多么复杂的列表样式均可解耦成一个一个的adapter

简单示例（具体请看详情介绍）：

mRv.setLayoutManager(LinearLayoutManager(this))//如果是GridLayoutManager需要提前设置好，Linear随意
val baseAdapter = createContainerAdapter()
mRv.setAdapter(baseAdapter.addAdapter(TextAdapter(),ImageAdapter()))
//...
baseAdapter.setListAndNotifyDataSetChanged(list)

ViewPager、RecyclerView、ViewPager2高度自适应第一个child

<androidx.viewpager2.widget.ViewPager2
    android:id="@+id/vp_pager"
    android:layout_width="match_parent"
    android:layout_height="1dp"/>//随便写一个高

//初始化时即可调用（如果child高度因数据再次变化，这里不会更新，请在合适时机再次调用，后续可能会进行优化）
ViewGroupWrapUtils.wrap(vp, false);

使用小贴士

本项目所有的adapter都会内部维护一个List，所以修改数据请一定要使用adapter.getList()，然后notify...

刷新list数据建议调用notifyListItem...方法，这样就不用处理header、footer数量了

关于增加多个header、footer：个人认为多个header、footer场景少并且双方都难以管理，所以请自行将header、footer设置成LinearLayout，然后自行添加维护

关于空状态：个人认为这不在adapter范畴（对上拉下拉、notifyItem等都会有交互问题实际上并不友好），自行写个空状态工具类反而更方便和简单（如有需要后续开放）

导入方式

你的build.gradle要有jitpack.io，大致如下

allprojects {
    repositories {
        maven { url 'http://maven.aliyun.com/nexus/content/groups/public/' }
        maven { url 'https://jitpack.io' }
        google()
        jcenter()
    }
}

然后： （api或）implementation 'com.github.weimingjue:BaseAdapter:5.0.0'

混淆要求： #请保留ViewBinding里的两个inflate方法，不然会反射不到 -keepclassmembers class * extends androidx.viewbinding.ViewBinding{ public static ** inflate(...); } #如果还是使用旧的那种继承方式请再保留ViewBinding类（createXxx不需要加） -keep class * extends androidx.viewbinding.ViewBinding