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 案例展示效果
- 实际项目中的效果图
![image](https://img-blog.csdnimg.cn/20200216115220512.png?ynotemdtimestamp=1581824371888)
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类型的布局是否可见,特别灵活!
参考案例说明
其他推荐说明
关于LICENSE
posted @
2020-02-16 12:31
潇湘剑雨yc
阅读(
296)
评论()
编辑
收藏
举报