RecycleView开源项目BRVAH分析

为了更好的理解源码以及RecycleViewAdapter的机制,先上一幅图

《RecycleView开源项目BRVAH分析》 RecycleView.PNG

其中HeaderView和FooterView可以包含多个View,LoadingMoreView在BRVAH中固定成了一个。OK重点来了,无论HeaderView里面包含了多少个Header,HeaderView会被整体当成一个Item,所以当Adapter需要刷新HeaderView的时候始终都是刷新position = 0的位置(同理,FooterView也是一个道理)

这里需要重点理解的是HeaderView中Header的数量和RecycleView整个Item数量之间的关系,BRVAH中,HeaderView和FooterView都是LinerLayout,向这个LinerLayout中增加View是不影响RecycleView的ItemCount的。千万不要想当然的认为Add了几个Header然后ItemCount就会加几了。这点理解了源代码理解起来就很容易了

下面主要看BRVAH中最重要的的类BaseQuickAdapter

先来看这个类的定义和构造函数
public abstract class BaseQuickAdapter<T, K extends BaseViewHolder> extends RecyclerView.Adapter<K>
public BaseQuickAdapter(int layoutResId, List<T> data) {
    this.mData = data == null ? new ArrayList<T>() : data;
    if (layoutResId != 0) {
        this.mLayoutResId = layoutResId;
    }
}

首先,这是个抽象类,继承了RecyclerView.Adapter,泛型K表示ViewHolder,泛型T表示了List的数据类型,这里个人觉得泛型的名称可以更加直意一些,方便理解。

来看一下主要成员变量的定义

//load more
private boolean mNextLoadEnable = false;
private boolean mLoadMoreEnable = false;
private boolean mLoading = false;
private LoadMoreView mLoadMoreView = new SimpleLoadMoreView();
private RequestLoadMoreListener mRequestLoadMoreListener;

mNextLoadEnable的含义是否还有下一页可以加载,用来判断是否还有更多数据
而mLoadMoreEnable表示是否要显示LoadMoreView
mLoading比较好理解,判断是否正在加载更多,用于是否显示进度的判断
mLoadMoreView这里给了一个初始化的View
mRequestLoadMoreListener用来CallBack给外部,表示LoadMore正在显示

 //header footer
private LinearLayout mHeaderLayout;
private LinearLayout mFooterLayout;
//empty
private FrameLayout mEmptyLayout;
private boolean mIsUseEmpty = true;
private boolean mHeadAndEmptyEnable;
private boolean mFootAndEmptyEnable;

header和footer都好理解,mEmptyLayout表示无数据时填充的布局,mIsUseEmpty表示默认使用这个EmptyLayout。mHeadAndEmptyEnable这个为true表示当无数据是可以显示HeaderView(mFootAndEmptyEnable这是同理,只是是否显示FooterView)

public static final int HEADER_VIEW = 0x00000111;
public static final int LOADING_VIEW = 0x00000222;
public static final int FOOTER_VIEW = 0x00000333;
public static final int EMPTY_VIEW = 0x00000555;

这几个值对应了getItemType返回值,比较好理解

其他成员变量比较好理解,基本就是动画的一些定义,按键Listener的定义等,可自行阅读

下面来看几个主要函数

public int getItemCount() {
    int count;
    if (getEmptyViewCount() == 1) {
        count = 1;
        if (mHeadAndEmptyEnable && getHeaderLayoutCount() != 0) {
            count++;
        }
        if (mFootAndEmptyEnable && getFooterLayoutCount() != 0) {
            count++;
        }
    } else {
        count = getHeaderLayoutCount() + mData.size() + getFooterLayoutCount() + getLoadMoreViewCount();
    }
    return count;
}
此函数返回需要渲染的Item数量,主要逻辑是,根据需要加上HeaderView和FooterView的数量,举例来看getHeaderLayoutCount()
    public int getHeaderLayoutCount() {
    if (mHeaderLayout == null || mHeaderLayout.getChildCount() == 0) {
        return 0;
    }
    return 1;
}

可以看出HeaderView的数量不是1就是0,与一开始图的理解在代码上就对应上了。FooterView和LoadMoreView也是一个道理

来看获取View类型的函数getItemViewType()
public int getItemViewType(int position) {
    //Part1
    if (getEmptyViewCount() == 1) {
        boolean header = mHeadAndEmptyEnable && getHeaderLayoutCount() != 0;
        switch (position) {
            case 0:
                if (header) {
                    return HEADER_VIEW;
                } else {
                    return EMPTY_VIEW;
                }
            case 1:
                if (header) {
                    return EMPTY_VIEW;
                } else {
                    return FOOTER_VIEW;
                }
            case 2:
                return FOOTER_VIEW;
            default:
                return EMPTY_VIEW;
        }
    }
    //Part2
    autoLoadMore(position);
    //Part3
    int numHeaders = getHeaderLayoutCount();
    if (position < numHeaders) {
        return HEADER_VIEW;
    } else {
        int adjPosition = position - numHeaders;
        int adapterCount = mData.size();
        if (adjPosition < adapterCount) {
            return getDefItemViewType(adjPosition);
        } else {
            adjPosition = adjPosition - adapterCount;
            int numFooters = getFooterLayoutCount();
            if (adjPosition < numFooters) {
                return FOOTER_VIEW;
            } else {
                return LOADING_VIEW;
            }
        }
    }
}
Part1代码逻辑:当无数据的时候根据Position和状态值来判断是HeaderVeiw,FooterView或者EmptyFrame
Part2代码逻辑:autoLoadMore显示加载更多的View(此处感觉这个函数放在这里并不合适,因为这是一个用来获取Type的函数,autoLoadMore是用来设置加载更多的View的)
Part3代码逻辑:根据HeaderView和FooterView的个数(0或者1)来返回是HeaderVIew类型,FooterView类型,LoadingMore类型或者是用户定义的类型(getDefItemViewType)

下面来看onCreateViewHolder

public K onCreateViewHolder(ViewGroup parent, int viewType) {
    K baseViewHolder = null;
    this.mContext = parent.getContext();
    this.mLayoutInflater = LayoutInflater.from(mContext);
    switch (viewType) {
        case LOADING_VIEW:
            baseViewHolder = getLoadingView(parent);
            break;
        case HEADER_VIEW:
            baseViewHolder = createBaseViewHolder(mHeaderLayout);
            break;
        case EMPTY_VIEW:
            baseViewHolder = createBaseViewHolder(mEmptyLayout);
            break;
        case FOOTER_VIEW:
            baseViewHolder = createBaseViewHolder(mFooterLayout);
            break;
        default:
            baseViewHolder = onCreateDefViewHolder(parent, viewType);
            bindViewClickListener(baseViewHolder);
    }
    baseViewHolder.setAdapter(this);
    return baseViewHolder;
}

返回值泛型K对应函数定义BaseQuickAdapter<T, K extends BaseViewHolder>定义的K,即返回一个Holader
接下来是根据不同类型来创建不同的ViewHolder。重点来说下onCreateDefViewHolder(parent, viewType)这个方法吧。这个方法最终调用了下面的方法

/**
 * if you want to use subclass of BaseViewHolder in the adapter,
 * you must override the method to create new ViewHolder.
 *
 * @param view view
 * @return new ViewHolder
 */
protected K createBaseViewHolder(View view) {
    Class temp = getClass();
    Class z = null;
    while (z == null && null != temp) {
        z = getInstancedGenericKClass(temp);
        temp = temp.getSuperclass();
    }
    K k = createGenericKInstance(z, view);
    return null != k ? k : (K) new BaseViewHolder(view);
}

getInstancedGenericKClass用来通过Adapter类获取泛型K所对应的真正的类
createGenericKInstance用来创建一个真正的泛型K对应的类
这两个方法都涉及到了反射的知识,这里稍作补充,以下方法都是Class类的方法

getGenericSuperclass用来获取超类的Type。ParameterizedType表示参数类型
getActualTypeArguments表示获取实际的参数类型

这里不太明白的是注释,为什么使用了继承自BaseViewHolder的类需要override这个方法

来看onBindViewHolder()方法

public void onBindViewHolder(K holder, int positions) {
    int viewType = holder.getItemViewType();
    switch (viewType) {
        case 0:
            convert(holder, mData.get(holder.getLayoutPosition() - getHeaderLayoutCount()));
            break;
        case LOADING_VIEW:
            mLoadMoreView.convert(holder);
            break;
        case HEADER_VIEW:
            break;
        case EMPTY_VIEW:
            break;
        case FOOTER_VIEW:
            break;
        default:
            convert(holder, mData.get(holder.getLayoutPosition() - getHeaderLayoutCount()));
            break;
    }
}

比较简单根据类型来填充布局内容,其中convert方法是个抽象方法,需要实现,完成布局内容的填充

至此,这个类的最主要的方法都分析完成。主要需要理解的有:

泛型的使用可以提高代码复用率

HeaderView和FooterView的ItemCount是0或者1,跟add多少个Header或者Footer没有关系

    原文作者:Conan_Lee
    原文地址: https://www.jianshu.com/p/32eb3ff7ba0e
    本文转自网络文章,转载此文章仅为分享知识,如有侵权,请联系博主进行删除。
点赞