Adapter分组封装

YCGroupAdapter

• 01.前沿说明
  • 1.1 案例展示效果
  • 1.2 该库功能和优势
  • 1.3 相关类介绍说明
• 02.如何使用
  • 2.1 如何引入
  • 2.2 最简单使用
  • 2.3 使用建议
• 03.常用api
  • 3.1 自定义adapter
  • 3.2 notify相关
  • 3.3 点击事件listener
• 04.实现步骤
  • 4.1 业务需求分析
  • 4.2 adapter实现多type
  • 4.3 这样写的弊端
  • 4.4 分组实体bean
  • 4.5 构建封装adapter
• 05.优化相关
• 06.关于参考
• 07.其他说明介绍

01.前沿说明

1.1 案例展示效果

• demo中的效果图
•       

• 实际项目中的效果图
•  

1.2 该库功能和优势

• 按组划分的自定义adapter适配器，一个recyclerView可以完成强大的group+children类型的业务需求。
• 每组支持添加header，footer，children，且每一个都支持设置多类型type的view视图。
• 支持局部插入刷新，局部移除刷新，也就是说可以按组插入或者移除数据，或者按组中child的某个未知插入或者移除数据。
• 支持组中header，footer，child的各个视图view的自定义点击事件。且返回具体的索引！
• 常见使用场景：仿懂车帝，汽车之家分组图片查看器；仿QQ联系人分组，可以折叠和伸展；以及复杂分组页面……
• 添加了object同步锁处理adapter中data添加，获取和移除等方法，有效避免多线程或者其他操作导致数据错位或者偶发性fast-fail。

02.如何使用

2.1 如何引入

• 如下所示

2.2 最简单使用

• 必须的三个步骤代码，如下所示

• 关于如何实现仿照QQ分组的功能

03.常用api

3.1 自定义adapter

• 代码如下所示

• 那么如何控制组中的header或者footer是否显示呢？
  • 返回true表示显示，返回false表示不显示……就是这么简单

3.2 notify相关

• 插入数据

• 移除数据

3.3 点击事件listener

• 设置组header点击事件

• 设置组footer点击事件

• 设置组中children点击事件

04.实现步骤

4.1 业务需求分析

• 比如在app开发中，产品说实现一个QQ分组的功能，要求有收叠功能。同时在app中，图片相册，仿照懂车帝实现分组图片。看到这样一个需求，思考能否用一个recyclerView实现，使用type来区分不同类型布局。
• RecyclerView 可以用ViewType来区分不同的item,也可以满足需求，但还是存在一些问题，比如：
  • 1，在item过多逻辑复杂列表界面，Adapter里面的代码量庞大，逻辑复杂，后期难以维护。
  • 2，每次增加一个列表都需要增加一个Adapter，重复搬砖，效率低下。
  • 3，无法复用adapter，假如有多个页面有多个type，那么就要写多个adapter。
  • 4，要是有局部刷新，那么就比较麻烦了，比如广告区也是一个九宫格的RecyclerView，点击局部刷新当前数据，比较麻烦。

4.2 adapter实现多个type

• 通常写一个多Item列表的方法
  • 根据不同的ViewType 处理不同的item，如果逻辑复杂，这个类的代码量是很庞大的。如果版本迭代添加新的需求，修改代码很麻烦，后期维护困难。
• 主要操作步骤
  • 在onCreateViewHolder中根据viewType参数，也就是getItemViewType的返回值来判断需要创建的ViewHolder类型
  • 在onBindViewHolder方法中对ViewHolder的具体类型进行判断，分别为不同类型的ViewHolder进行绑定数据与逻辑处理
• 代码如下所示

4.3 这样写的弊端

• 上面那样写的弊端
  • 类型检查与类型转型，由于在onCreateViewHolder根据不同类型创建了不同的ViewHolder，所以在onBindViewHolder需要针对不同类型的ViewHolder进行数据绑定与逻辑处理，这导致需要通过instanceof对ViewHolder进行类型检查与类型转型。
  • 不利于维护，这点应该是上一点的延伸，随着列表中布局类型的增加与变更，getItemViewType、onCreateViewHolder、onBindViewHolder中的代码都需要变更或增加，Adapter 中的代码会变得臃肿与混乱，增加了代码的维护成本。
  • 比如，在分组控件中，类似QQ分组那样，点击组中的header，可以切换关闭和伸展该组中children的自选项item，那么如果不封装，adapter对数据处理也比较麻烦。
  • 有时候，在分组控件中，有的组不想显示header，有的组不想显示footer，那么这个时候就不太灵活。能否使用一个开关方法来控制header和footer的显示和隐藏呢？

4.4 分组实体bean

• 通过GroupStructure记录每个组是否有头部，是否有尾部和子项的数量。从而能方便的计算列表的长度和每个组的组头、组尾和子项在列表中的位置。

4.5 构建封装adapter

• 核心目的就是三个
  • 避免类的类型检查与类型转型
  • 增强Adapter的扩展性
  • 增强Adapter的可维护性
• 当列表中类型增加或减少时Adapter中主要改动的就是getItemViewType、onCreateViewHolder、onBindViewHolder这三个方法，因此，我们就从这三个方法中开始着手。
• 在getItemViewType方法中。
  • if之类的逻辑判断简化代码，可以简单粗暴的用作为TYPE_HEADER，TYPE_FOOTER，TYPE_CHILD增加type标识。
  • 既然是分组adapter，首先是获取组的索引，然后通过组的索引来判断type的类型，最后在返回具体的itemType类型。

• 在onCreateViewHolder方法中
  • 创建viewHolder，主要作用是创建Item视图，并返回相应的ViewHolder。这个地方，需要注意一下，在分组控件中，能否把组的header，footer，children等布局暴露给外部开发者创建？
  • 因此，这里需要区分类型，然后返回对应的布局，这里返回对应的布局几个方法，可以弄成抽象的方法，子类必须实现。让子类返回具体的header，footer，children布局。

• 在onBindViewHolder方法中
  • 这个方法中主要做两个事情，第一个是设置组中的header，footer，还有children的点击事件，并且需要返回具体的索引，包括组索引，和组中孩子的索引。
  • 第二个是绑定viewHolder，主要作用是绑定数据到正确的Item视图上，这个可以把方法抽象，让子类去实现。

• 封装后好处
  • 拓展性——每组支持添加header，footer，children，且每一个都支持设置多类型type的view视图。而且支持局部插入刷新，局部移除刷新，也就是说可以按组插入或者移除数据，或者按组中child的某个未知插入或者移除数据。
  • 可维护性——不同的列表类型由adapter添加header，footer，children类型处理，相互之间互不干扰，代码简洁，维护成本低。还可以灵活控制header，footer类型的布局是否可见，特别灵活！

参考案例说明

• https://github.com/msdx/group-recycler-adapter
• https://www.jianshu.com/p/7b5607a7fbe1
• https://www.jianshu.com/p/26b0911f396f
• https://github.com/donkingliang/GroupedRecyclerViewAdapter
• https://www.jianshu.com/p/1558cbd20d17

其他推荐说明

• 1.技术博客汇总
• 2.开源项目汇总
• 3.生活博客汇总
• 4.喜马拉雅音频汇总
• 5.其他汇总
• 6.重点推荐：博客笔记大汇总，开源文件都是md格式

关于LICENSE

开源库地址：https://github.com/yangchong211/YCGroupAdapter