Adapter encapsulated packet

YCGroupAdapter

• 01. Description forefront
  • 1.1 Case effects
  • 1.2 The library features and benefits
  • 1.3 Class Description Description
• 02. How to use
  • 2.1 how to introduce
  • 2.2 The easiest to use
  • 2.3 recommendations
• 03. Common api
  • 3.1 custom adapter
  • 3.2 notify the relevant
  • 3.3 click event listener
• 04. Implementation steps
  • 4.1 Business requirements analysis
  • 4.2 adapter multi-type
  • 4.3 write drawbacks
  • 4.4 entity bean grouping
  • 4.5 Construction of the package adapter
• 05. optimization related
• 06. About Reference
• 07. Other notes Introduction

01. Description forefront

1.1 Case effects

• Effect of FIG demo
•       

• The actual project renderings
•  

1.2 The library features and benefits

• By custom adapter adapter group is divided, and can complete a recyclerView powerful group + children type of business needs.
• Each support adding header, footer, children, and each supports a set of multi-type view type view.
• Support local insertion refresh, partial refresh removed, which means you can insert or remove data by group, or by an unknown group in the child's insertion or removal of data.
• Support group header, footer, child custom click event of each view view. And returns the specific index!
• Common usage scenarios: Emperor imitation understand the car, the car home group picture viewer; imitation QQ contact group, can be folded and stretch; and complex grouping pages ......
• Added synchronization lock object adapter in processing data to add, remove, and obtain other methods, effectively avoid multi-threading or other operations cause sporadic data misalignment or fast-fail.

02. How to use

2.1 how to introduce

• As follows

2.2 The easiest to use

• The three steps must code as follows
• Function modeled on how to achieve QQ packets

03. Common api

3.1 custom adapter

• Code shown below
• So how to control the group header or footer whether to show it?
  • Returns true if the display returns false representation does not show is that simple ......

3.2 notify the relevant

• Insert data
• Remove data

3.3 click event listener

• Set the group header click event
• Setting Group footer click event
• Setup group children click event

04. Implementation steps

4.1 Business requirements analysis

• 比如在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. Recommend: Large blog notes summary, open source file format is md

About LICENSE

Open source library Address: https://github.com/yangchong211/YCGroupAdapter