为了更好的理解源码以及RecycleViewAdapter的机制,先上一幅图
其中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方法是个抽象方法,需要实现,完成布局内容的填充
至此,这个类的最主要的方法都分析完成。主要需要理解的有:
泛型的使用可以提高代码复用率