这篇文章本来年前就想要发布的,但是因为工作比较忙,一直没什么时间,而且还有bug没解决。
最近项目刚好做完,也就抽机会,重新对项目进行了一些优化,发布到网上,也算是对自己思路的一个总结和概括吧!
先简单介绍一下用法:
1.单一格式的列表:
mRecyclerView = (RecyclerView) findViewById(R.id.recyclerview);
for(int i = 1; i <= 50; i ++) {
User user = new User();
user.setAge(i + 10);
user.setName("张三" + i);
userList.add(user);
}
LinearLayoutManager layoutManager = new LinearLayoutManager(this);
mRecyclerView.setLayoutManager(layoutManager);
QuickAdapter adapter = new QuickAdapter<User>(userList, this, R.layout.layout_item, null) {
@Override
public void onBindData(QuickHolder holder, int position, User user) {
holder.setText(R.id.test_tv, user.getName()).setText(R.id.text, user.getAge() + "");
}
};
mRecyclerView.setAdapter(adapter);
2.如果你需要添加头布局和尾布局,只需要添加如下代码:
adapter.addFoofer(R.layout.layout_footer);
adapter.addHeader(R.layout.layout_header);
为header和footer设置数据,支持链式调用:
@Override
public void onBindFooter(QuickHolder holder) {
super.onBindFooter(holder);
holder.setText(R.id.footer_tv, R.layout.layout_footer, "小尾巴~~~");
}
@Override
public void onBindHeader(QuickHolder holder) {
super.onBindHeader(holder);
holder.setText(R.id.header_tv, R.layout.layout_header, "头布局").setImage(R.id.header_iv, R.layout.layout_header, R.mipmap.shopdetail_bg);
}
3.除了头布局和尾布局,还支持其他不同类型item:
@Override
public int getViewType(int position) {
if(position % 5 == 0) {
return 1001;
} else {
return 1002;
}
}
@Override
public int getItemViewId(int viewType) {
if(viewType == 1001) {
return R.layout.layout_test;
}
return R.layout.layout_item;
}
同样,在绑定数据的时候,需要同时专递layoutid和viewid:
holder.setText(R.id.test_tv, user.getName()).setText(R.id.text, user.getAge() + "");
holder.setText(R.id.top_tv, R.layout.layout_test, user.getName()).setImage(R.id.top_iv, R.layout.layout_test, R.mipmap.ic_launcher);
除此以外,还有其他特性。总体概括如下:
1.API使用简单、快捷
2.支持头布局、尾布局,和其他多种item
3.支持链式调用
4.gridLayoutManager情况下,默认头布局和尾布局占据整行(需要传递gridLayoutManager到适配器中)
5.view通过sparseArray进行缓存,最大程度的节约内存
6.支持item点击事件
下面我们开始讲解关键代码:
@Override
public QuickHolder onCreateViewHolder(ViewGroup parent, int viewType) {
View view;
int layoutId;
if(getItemViewId(viewType) > 0) {
//有多种类型的item
view = LayoutInflater.from(mContext).inflate(getItemViewId(viewType), parent, false);
layoutId = getItemViewId(viewType);
} else {
//只有一种item
view = LayoutInflater.from(mContext).inflate(commonLayoutId, parent, false);
layoutId = commonLayoutId;
}
if(viewType == TYPE_HEADER && headerId > 0) {//有header
view = LayoutInflater.from(mContext).inflate(headerId, parent, false);
layoutId = headerId;
}else if (viewType == TYPE_FOOTER && footerId > 0) {//有footer
view = LayoutInflater.from(mContext).inflate(footerId, parent, false);
layoutId = footerId;
}
if(mOnItemClickListener != null){
return new QuickHolder(view, mOnItemClickListener, layoutId, commonLayoutId, mContext);
} else {
return new QuickHolder(view, null, layoutId, commonLayoutId, mContext);
}
}
首先我们看onCreateViewHolder函数中,为了支持多种item,这里做了多个判断,并且会将不同的viewtype获取的view和id,传递给viewholder。先不管viewholder,我们先看看getItemViewId里面的处理:
/**
* 通过viewType返回对应的layoutId
* @param viewType
* @return layoutId
*/
public int getItemViewId(int viewType) {
return 0;
}
上面已经注释的很清楚了,通过viewtype获取layoutid,所以通过重写该方法,我们可以返回不同的layoutid,来加载多种item。那么我们看看viewtype又是如何返回的:
//返回不同类型
@Override
public int getItemViewType(int position) {
if(headerId > 0 && position < 1) {
return TYPE_HEADER;
}else if (footerId > 0 && position == getItemCount() -1 ){
return TYPE_FOOTER;
} else {
return getViewType(position);
}
}
/**
* 获取不同的viewtype
* @param position
* @return
*/
public int getViewType(int position) {
return TYPE_COMMON;
}
可以看到,这里默认定义了header和footer,并且在不是header和footer时,通过getViewType函数来获取更多类型。
然后是绑定数据的函数:
private void executeBindData(QuickHolder holder, int position) {
if(headerId > 0 && footerId > 0) {//当header和footer同时存在
if(position > 0) {
if(position <= mList.size()) {
onBindData(holder, position - 1, mList.get(position - 1));
} else {
onBindFooter(holder);
}
} else {
onBindHeader(holder);
}
} else {
if(headerId > 0) {//只有header
if(position == 0) {
onBindHeader(holder);
} else {
onBindData(holder, position - 1, mList.get(position - 1));
}
} else if(footerId > 0) {//只有footer
if(position == mList.size()) {
onBindFooter(holder);
} else {
onBindData(holder, position, mList.get(position));
}
} else{//以上都没有
onBindData(holder, position, mList.get(position));
}
}
}
这里很简单,只是把header和footer和其他item进行了一下区分,避免一个函数过于臃肿。然后在onBindViewHolder函数中进行调用:
@Override
final public void onBindViewHolder(QuickHolder holder, int position) {
executeBindData(holder, position);
}
这里使用final,主要是为了防止子类重写。
好了,Adapter里面的代码就讲解完了,我们再看看ViewHolder里面做了哪些处理:
public QuickHolder(final View itemView, QuickAdapter.OnItemClickListener onItemClickListener, @LayoutRes int rId, @LayoutRes int cId, Context context) {
super(itemView);
this.mOnItemClickListener = onItemClickListener;
commonLayoutId = cId;
mContext = context;
itemViews.put(rId, itemView);
itemView.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
if(mOnItemClickListener != null) {
/**
* 这里需要注意一下,如果有添加header的情况下,要把position - 1
*/
mOnItemClickListener.onClick(itemView, getAdapterPosition());
}
}
});
}
可以看到构造函数中,主要都是一些赋值操作,最重要的一步是:
itemViews.put(rId, itemView);
它是把我们传递进来的view缓存到SparseArray中,后面我们在使用的时候,就可以直接取了。
然后我们看看setText函数所做的操作:
public QuickHolder setText(@IdRes int id, @LayoutRes int layoutId, String text) {
TextView textView = (TextView) views.get(id);
if(textView == null) {
View view = getItemView(layoutId);
if(view == null) {
view = LayoutInflater.from(mContext).inflate(layoutId, null);
itemViews.put(layoutId, view);
}
textView = (TextView) view.findViewById(id);
views.put(id, textView);
}
textView.setText(text);
return this;
}
可以看到,基本就是先从缓存获取控件,获取不到再通过findviewbyId获取控件,然后为textview设置值,最后返回viewholder,使得它可以支持链式调用。
代码已上传至[github]:https://github.com/langxing/Application
感兴趣的,可以下载查看源码。