文档章节

BaseRecyclerViewAdapterHelper开源项目之BaseSectionQuickAdapter 实现分组效果的源码学习

A
 Angels_安杰
发布于 2017/03/22 12:07
字数 1971
阅读 299
收藏 0

version:2.8.5 

更多分享请看:http://cherylgood.cn

今天我们来学习下BaseRecyclerViewAdapterHelpler开源项目中是如何实现分组想过的。

首先今天的学习我们还是按照前面的学习思路,根据getItemViewType->onCreateDefViewHolder->onBindViewHolder,即从确认viewholder类型->根据类型值创建viewholder->根据数据源类型绑定数据到viewholder上。

第一步:我们看一下BaseSectionQuickAdapter这个类的定义

public abstract class BaseSectionQuickAdapter extends BaseQuickAdapter<T, K> {

跟前面分析的多类型BaseMultiItemQuickAdapter差不多,只是我们的数据源需要继承自SetionEntity。那么这个SetionEntity做了什么事呢,我们来看下源码:

package com.chad.library.adapter.base.entity;

/**
 * https://github.com/CymChad/BaseRecyclerViewAdapterHelper
 */
public abstract class SectionEntity {
    public boolean isHeader;
    public T t;
    public String header;

    public SectionEntity(boolean isHeader, String header) {
        this.isHeader = isHeader;
        this.header = header;
        this.t = null;
    }

    public SectionEntity(T t) {
        this.isHeader = false;
        this.header = null;
        this.t = t;
    }
}

从源码可以看出,他是一个抽象类,可能你会问,为什么要定义成抽象类呢,为什么不定义成接口或者普通类呢。

以下理由仅由我意想得出,大家也可以发表下自己的看法:

1、我们定义SectionEntity这个类,目的自然是希望用户的bean都具有某些规范,而我们的BaseSectionQuickAdapter将根据该规范进行数据的处理。虽然使用普通类一样能达到相同的效果,但是不推荐,我觉得这让有可能会让用户忽略我们所需要让用户知道的规范。

2、接口类,接口类其实是特殊的抽象类,上次分析的MultiItemEntity为什么又定义成接口类型呢,

public interface MultiItemEntity {

    int getItemType();

}

根据实际需求而定,因为我们在实现多类型时,只需要用户的数据源提供一个类型值给我们即可,所以此时定义成接口类是最为合适的,因为用户数据源只要实现了该接口,他必须实现接口的方法,而我们需要的恰恰是在使用时调用该接口即可。

但是在SetionEntity中,我们帮用户多做点事,为其提供两个构造方法,一个时分组头,一个是分组体。而此时如果是定义成接口类,是不符合需求的,因为接口类的方法不能有方法体等。

SectionEntity代码分析:从源码可以看出,假如我们当前数据是分组头,那么我们在创建bean时使用

public SectionEntity(boolean isHeader, String header) {
        this.isHeader = isHeader;
        this.header = header;
        this.t = null;
    }

即可,当前定义分组头只有个string类型的分组头名字,你在继承时可以根据实际需求进行扩展,内部调用父类的该构造方法即可。

如果时普通的数据bean:调用以下构造方法即可,当然你也可以进行扩展,根据个人需求而定。

public SectionEntity(T t) {
        this.isHeader = false;
        this.header = null;
        this.t = t;
    }

看完了SectionEntity。我们来看BaseSectionQuickAdapter的源码:

package com.chad.library.adapter.base;

import android.view.ViewGroup;

import com.chad.library.adapter.base.entity.SectionEntity;

import java.util.List;

/**
 * https://github.com/CymChad/BaseRecyclerViewAdapterHelper
 */
public abstract class BaseSectionQuickAdapter extends BaseQuickAdapter<T, K> {


    protected int mSectionHeadResId;
    protected static final int SECTION_HEADER_VIEW = 0x00000444;

    /**
     * Same as QuickAdapter#QuickAdapter(Context,int) but with
     * some initialization data.
     *
     * @param sectionHeadResId The section head layout id for each item
     * @param layoutResId      The layout resource id of each item.
     * @param data             A new list is created out of this one to avoid mutable list
     */
    public BaseSectionQuickAdapter( int layoutResId, int sectionHeadResId, List data) {
        super(layoutResId, data);
        this.mSectionHeadResId = sectionHeadResId;
    }

    @Override
    protected int getDefItemViewType(int position) {
        return  mData.get(position).isHeader ? SECTION_HEADER_VIEW : 0;
    }

    @Override
    protected K onCreateDefViewHolder(ViewGroup parent, int viewType) {
        if (viewType == SECTION_HEADER_VIEW)
            return createBaseViewHolder(getItemView(mSectionHeadResId, parent));

        return super.onCreateDefViewHolder(parent, viewType);
    }

    @Override
    public void onBindViewHolder(K holder, int positions) {
        switch (holder.getItemViewType()) {
            case SECTION_HEADER_VIEW:
                setFullSpan(holder);
                convertHead(holder, mData.get(holder.getLayoutPosition() - getHeaderLayoutCount()));
                break;
            default:
                super.onBindViewHolder(holder, positions);
                break;
        }
    }

    protected abstract void convertHead(BaseViewHolder helper, T item);

}

大家可以看到,源码比较少,跟BaseMultiItemQuickAdapter是一样的思路。

字段解析:

protected int mSectionHeadResId;

mSectionHeadResId用来保存我们分组头的布局资源ids;

protected static final int SECTION_HEADER_VIEW = 0x00000444;

定义了一个默认的分组头类型。思想与实现多类型一致;

我们在实例化BaseSectionQuickAdapter时需要多传递一个分组头的资源ids过来,所以构造方法是这样的:

/**
     * Same as QuickAdapter#QuickAdapter(Context,int) but with
     * some initialization data.
     *
     * @param sectionHeadResId The section head layout id for each item
     * @param layoutResId      The layout resource id of each item.
     * @param data             A new list is created out of this one to avoid mutable list
     */
    public BaseSectionQuickAdapter( int layoutResId, int sectionHeadResId, List data) {
        super(layoutResId, data);
        this.mSectionHeadResId = sectionHeadResId;
    }

构造好之后,我们也是利用来adapter的生命周期方法:

1、重写getDefItemViewType方法,前面也解释过为什么不是重写Recycler.adapter的getItemViewType方法,以为我们的BaseQuickAdapter对其进行来包装。最终在getItemViewType方法中会调用我们的getDefItemViewType方法。

重写该方法所做的事不多:

@Override
    protected int getDefItemViewType(int position) {
        return  mData.get(position).isHeader ? SECTION_HEADER_VIEW : 0;
    }

根据我们当前位置的数据bean,判断当前节点的数据bean是不是分组头bean,如果是,返回SECTION_HEADER_VIEW告诉BaseQuickAdapter,你要创建的viewholder是分组头类型的viewholder。否则返回0(0时RecyclerView.Adapter的缺省值,前面有分析)
接下来,我们也同样是重写了onCreateDefViewHolder方法。

@Override
    protected K onCreateDefViewHolder(ViewGroup parent, int viewType) {
        if (viewType == SECTION_HEADER_VIEW)
            return createBaseViewHolder(getItemView(mSectionHeadResId, parent));

        return super.onCreateDefViewHolder(parent, viewType);
    }

根据返回的类型值,如果是SECTION_HEADER_VIEW 那么我们就创建一个分组头viewholder返回。否则调用父类的方法按原流程走。

在这里我们还需要重写onBindViewHolder方法,因为我们要多做两件事情:

1、对我们的分组头进行特殊处理;

2、增加一个分组头数据绑定的抽象方法的调用;

@Override
    public void onBindViewHolder(K holder, int positions) {
        switch (holder.getItemViewType()) {
            case SECTION_HEADER_VIEW:
                setFullSpan(holder);
                convertHead(holder, mData.get(holder.getLayoutPosition() - getHeaderLayoutCount()));
                break;
            default:
                super.onBindViewHolder(holder, positions);
                break;
        }
    }

里面有个很有趣的方法。setFullSpan,从字面上理解是设置充满空间,我们来看下代码:

/**
     * When set to true, the item will layout using all span area. That means, if orientation
     * is vertical, the view will have full width; if orientation is horizontal, the view will
     * have full height.
     * if the hold view use StaggeredGridLayoutManager they should using all span area
     *
     * @param holder True if this item should traverse all spans.
     */
    protected void setFullSpan(RecyclerView.ViewHolder holder) {
        if (holder.itemView.getLayoutParams() instanceof StaggeredGridLayoutManager.LayoutParams) {
            StaggeredGridLayoutManager.LayoutParams params = (StaggeredGridLayoutManager.LayoutParams) holder
                    .itemView.getLayoutParams();
            params.setFullSpan(true);
        }
    }

里面原来是对Layoutmanager为StaggeredGridLayoutManager类型时做特殊处理,大家可以去了解下StaggeredGridLayoutManager这种类型的LayoutManager。

最后会调用一个方法

params.setFullSpan(true);

继续看该方法源码:

/**
         * When set to true, the item will layout using all span area. That means, if orientation
         * is vertical, the view will have full width; if orientation is horizontal, the view will
         * have full height.
         *
         * @param fullSpan True if this item should traverse all spans.
         * @see #isFullSpan()
         */
        public void setFullSpan(boolean fullSpan) {
            mFullSpan = fullSpan;
        }

该方法是StaggeredGridLayoutManager提供的,英文说明的大意是:

如果你设置true,当前item将使用布局的所有空间。如果是垂直的,会沾满水平方向的宽度空间,如果是水平,会占满垂直方向的高度空间。

然后将holder和当前节点的数据bean作为参数调用convertHead函数。

所以当你实现的是帶分组头的adapter时,会多出一个数据绑定的回调接口:

protected abstract void convertHead(BaseViewHolder helper, T item);

可能你还会看到以下代码:

convertHead(holder, mData.get(holder.getLayoutPosition() - getHeaderLayoutCount()));

里面有一句holder.getLayoutPosition()。

getLayoutPosition是干什么用的呢,因为RecyclerView的item的布局和渲染其实是交给layoutManager来完成的,所以adapter中的item的位置可能跟data的index匹配不上,而getLayoutPosition将返回给我们当前viewholder在recyclerView中的最新位置信息。

总结:分析思路还是老套路,根据一个组件的生命周期及业务流程进行分析,掌握一个控件的执行流程是理解一个控件的实现的一个较好的方法,本人是这么认为的,也是这么做的,大家有更好的学习方法可以多多留言,多多交流,没有最好,只有更好!以上即为本次的代码学习,希望对大家有帮助。后面会继续分析其他功能的源码,欢迎一起学习!

 

© 著作权归作者所有

A
粉丝 5
博文 138
码字总数 105958
作品 0
广州
程序员
私信 提问
Data binding 入坑笔记四列表适配器用法

Data binding 入坑笔记一入门篇 Data binding 入坑笔记二进阶篇之双向绑定 Data binding 入坑笔记三layout表达式详解 这一篇咱们来讲讲如何在 中的 来使用Data binding,这个比较重要,因为毕...

LaxusJ
2017/11/24
0
0
最近开发的一款应用,我选择了哪些框架 & 第三方库

小秋魔盒 采用的第三方库 最近利用闲暇时间,写了一款生活工具类的应用,开始的目的也主要是为了熟练一些老框架和熟悉一些新框架或者第三方库,大家可以把它看成一款练手的 Demo 应用吧!这里...

OCNYang
2017/08/22
0
0
android 常用第三方插件收藏

1、android-vertical-slide-view : 仿照淘宝和聚美优品,在商品详情页,向上拖动时,可以加载下一页。使用ViewDragHelper,滑动比较流畅。 2、Android-MaterialRefreshLayout :这是一个下拉...

ch10mmt
2018/06/26
0
0
BRVAH(让RecyclerView变得更高效)(1)

本文来自网易云社区 作者:吴思博 对于RecyclerView, 我们重复编写着那一个又一个的列表界面,有的要分组,有的要添加广告头部、有的要不同类型item排列、等等需求,主要代码有大部分是重复...

网易云
2018/09/30
0
0
可自定义扩展底部列表对话框ListBottomSheetDialogFragment

因为需要,为了方便,构建了一个可以自定义扩展的底部列表对话框,可以应付大部分场景。效果图如下:1.默认实现:2.自定义列表实现3.自定义头部和列表实现 一.可实现功能 1.默认可实现通用列...

明月春秋
2018/11/17
14
0

没有更多内容

加载失败,请刷新页面

加载更多

计算机实现原理专题--二进制减法器(二)

在计算机实现原理专题--二进制减法器(一)中说明了基本原理,现准备说明如何来实现。 首先第一步255-b运算相当于对b进行按位取反,因此可将8个非门组成如下图的形式: 由于每次做减法时,我...

FAT_mt
昨天
6
0
好程序员大数据学习路线分享函数+map映射+元祖

好程序员大数据学习路线分享函数+map映射+元祖,大数据各个平台上的语言实现 hadoop 由java实现,2003年至今,三大块:数据处理,数据存储,数据计算 存储: hbase --> 数据成表 处理: hive --> 数...

好程序员官方
昨天
7
0
tabel 中含有复选框的列 数据理解

1、el-ui中实现某一列为复选框 实现多选非常简单: 手动添加一个el-table-column,设type属性为selction即可; 2、@selection-change事件:选项发生勾选状态变化时触发该事件 <el-table @sel...

everthing
昨天
6
0
【技术分享】TestFlight测试的流程文档

上架基本需求资料 1、苹果开发者账号(如还没账号先申请-苹果开发者账号申请教程) 2、开发好的APP 通过本篇教程,可以学习到ios证书申请和打包ipa上传到appstoreconnect.apple.com进行TestF...

qtb999
昨天
10
0
再见 Spring Boot 1.X,Spring Boot 2.X 走向舞台中心

2019年8月6日,Spring 官方在其博客宣布,Spring Boot 1.x 停止维护,Spring Boot 1.x 生命周期正式结束。 其实早在2018年7月30号,Spring 官方就已经在博客进行过预告,Spring Boot 1.X 将维...

Java技术剑
昨天
18
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部