1. 说明
在我们真正开发项目的过程,我相信肯定每一个app里边都离不开展示列表的功能,而我们目前可以展示列表的控件也不外乎这么几种,ListView、GridView、RecyclerView等等,其实我们大家都知道,在我们项目中肯定不止一个地方运用到列表展示,肯定会有多个地方,就拿RecyclerView来说,它对应的每一个Adapter中肯定都会去 写这些代码:
比如ViewHolder、条目的点击、onCreateViewHolder()、onBindViewHolder()、getItemCount()、getViewType()等等这些方法,如果我们在每一个Adapter中都去写这么多的重复代码,那么我们最后的代码量是非常之大,而且也会导致代码冗余,这个也违背了我们封装的代码原则,而且也会让我们开发者做很多的重复工作,代码阅读性也会比较差,那么基于这几个原因,我们这节课就一起来针对于RecyclerView来打造一个万能的Adapter,我们的ListView有一个万能的 adapter,这个不是我们这节课的重点,我们今天重点来看下RecyclerView是如何实现万能的Adapter。
2. 分析
2.1 参数做到通用,就只能用泛型;
2.2 onCreateViewHolder()方法中每个布局文件的id不一样,所以就只能通过参数传递;
2.3 ViewHolder肯定是必不可少的,那么就只能写一个通用的;
3. 点击事件和长按事件
点击事件如下:
3.1 单独写一个接口
public interface ItemClickListener {
public void onItemClick(int position) ;
}
public interface ItemLongClickListener {
public boolean onItemLongClick(int position) ;
}
3.2 然后在adapter中写
// 利用接口 -> 给RecyclerView设置点击事件
public ItemClickListener mItemClickListener ;
// 长按事件
public ItemLongClickListener mItemLongClickListener ;
public void setOnItemLongClickListener(ItemLongClickListener itemLongClickListener){
this.mItemLongClickListener = itemLongClickListener ;
}
public void setOnItemLongClickListener(ItemLongClickListener itemLongClickListener){
this.mItemLongClickListener = itemLongClickListener ;
}
3.3 然后在adapter中的onBindViewHolder中
@Override
public void onBindViewHolder(ViewHolder holder, final int position) {
// ViewHolder优化
convert(holder , mData.get(position) , position) ;
// 条目的点击事件
if (mItemClickListener != null){
holder.itemView.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
mItemClickListener.onItemClick(position);
}
});
}
// 条目的长按点击事件
if (mItemLongClickListener != null){
holder.itemView.setOnLongClickListener(new View.OnLongClickListener() {
@Override
public boolean onLongClick(View v) {
return mItemLongClickListener.onItemLongClick(position);
}
});
}
}
}
3.4 在对应Activity中给RecyclerView设置完数据之后,利用回调给其设置点击事件
/**
* 显示列表数据
*
* @param categoryList
*/
private void showListData(List categoryList) {
// 这里在在最外层定义一个集合,用于接收请求接口的数据,
// 其实这里也可以不用在最外层定义list集合来接收数据,直接使用接口返回的categoryList数据也是可以的
mData = categoryList;
listAdapter = new CategoryListAdapter_2(this, mData);
recycler_view.setAdapter(listAdapter);
// 设置数据后就要给RecyclerView设置点击事件
listAdapter.setOnItemClickListener(new ItemClickListener() {
@Override
public void onItemClick(int position) {
// 这里本来是跳转页面 ,我们就在这里直接让其弹toast来演示
Toast.makeText(NHDZListActivity.this , mData.get(position).getName() , Toast.LENGTH_SHORT).show();
}
});
listAdapter.setOnItemLongClickListener(new ItemLongClickListener() {
@Override
public boolean onItemLongClick(int position) {
Toast.makeText(NHDZListActivity.this , "长按 :"+mData.get(position).getName() , Toast.LENGTH_SHORT).show();
// 在这里返回true,表示只响应长按事件,不会去相应点击事件
return true;
}
});
}
4. 代码如下
万能的Adapter代码如下:
/**
* Created by JackChen on 2018/3/4.
* description: RecyclerView的万能的Adapter
*
*/
public abstract class RecyclerCommonAdapter extends RecyclerView.Adapter{
// 每个布局文件的id不一样,所以就只能通过参数传递;
private int mLayoutId ;
// 参数做到通用,就只能用泛型;DATA这里只是泛型的意思,可以写任意东西,T也是可以的
protected List mData ;
// 实例化View的 LayoutInflate
private LayoutInflater mInflater ;
protected Context mContext ;
private MutiliTypeSupport mutiliTypeSupport ;
// 构造方法 - 参数1是list集合的数据,参数二是布局id
public RecyclerCommonAdapter(Context context , List data , int layoutId){
// mInflater 写到构造方法这里目的是只去创建一次这个对象,当然直接用LayoutInflater.from(context)在onCreateViewHolder()中去写也是可以的
// 缺点就是每次都会去创建mInflater对象的
mInflater = LayoutInflater.from(context) ;
this.mData = data ;
this.mLayoutId = layoutId ;
this.mContext = context ;
}
public RecyclerCommonAdapter(Context context , List data , MutiliTypeSupport typeSupport){
this(context , data , -1) ;
this.mutiliTypeSupport = typeSupport ;
}
// 创建布局
@Override
public ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
if (mutiliTypeSupport != null){
// 说明需要多布局
mLayoutId = viewType ;
}
// 创建布局view 需要context
View itemView = mInflater.inflate(mLayoutId , parent , false) ;
return new ViewHolder(itemView);
}
/**
* 在调用onCreateViewHolder()方法之前会先调用 getItemViewType()方法
* @param position
* @return
*/
@Override
public int getItemViewType(int position) {
// 多布局问题
if (mutiliTypeSupport != null){
return mutiliTypeSupport.getLayoutId(mData.get(position)) ;
}
return super.getItemViewType(position);
}
@Override
public void onBindViewHolder(ViewHolder holder, final int position) {
// ViewHolder优化
convert(holder , mData.get(position) , position) ;
// 条目的点击事件
if (mItemClickListener != null){
holder.itemView.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
mItemClickListener.onItemClick(position);
}
});
}
// 条目的长按点击事件
if (mItemLongClickListener != null){
holder.itemView.setOnLongClickListener(new View.OnLongClickListener() {
@Override
public boolean onLongClick(View v) {
return mItemLongClickListener.onItemLongClick(position);
}
});
}
}
/**
* 把必要的参数传递出去
* @param holder ViewHolder
* @param item 当前位置的条目
* @param position 当前位置
*/
protected abstract void convert(ViewHolder holder, DATA item, int position);
@Override
public int getItemCount() {
return mData.size();
}
// 利用接口 -> 给RecyclerView设置点击事件
public ItemClickListener mItemClickListener ;
// 长按事件
public ItemLongClickListener mItemLongClickListener ;
public void setOnItemClickListener(ItemClickListener itemClickListener){
this.mItemClickListener = itemClickListener ;
}
public void setOnItemLongClickListener(ItemLongClickListener itemLongClickListener){
this.mItemLongClickListener = itemLongClickListener ;
}
}
具体Adapter代码如下:
/**
* Created by JackChen on 2018/3/4.
* Email: [email protected]
* Description: 内涵段子列表数据的 adapter
*
* 这个是最基本的adapter写法
*
*/
// 注意1. 自己写的Adapter 继承自 RecyclerView.Adapter,
// 还要添加泛型,泛型也是自己写的 Adapter下的ViewHolder,而不是RecyclerView下的ViewHolder
public class CategoryListAdapter_2 extends RecyclerCommonAdapter {
private Context mContext ;
public CategoryListAdapter_2(Context context, List data) {
super(context, data, R.layout.channel_list_item);
this.mContext = context ;
}
// 注意3. 这里的绑定数据的 参数1的ViewHolder也是自己 写的Adapter下的 ViewHolder,而不是RecyclerView下的ViewHolder
// 显示布局 绑定数据
// @Override
// public void onBindViewHolder(CategoryListAdapter_2.ViewHolder holder, final int position) {
// // 在这里取出 Activity中请求接口的list集合数据,然后给 item 中 每个子控件去设置数据
// final ChannelListResult.DataBean.
// CategoriesBean.CategoryListBean item = mData.get(position) ;
// Glide.with(mContext).load(item.getIcon_url()).into(holder.channel_icon) ;
//
//
// // 名字
// holder.channel_text.setText(item.getName());
// // 内容
// holder.channel_topic.setText(item.getIntro());
//
// // 显示数据 因为最下边数据是:左边灰色,右边粉红色,所以这里使用html
// String str = item.getSubscribe_count() + " 订阅 | " +
// "总帖数 " + item.getTotal_updates() + "";
// holder.channel_update_info.setText(Html.fromHtml(str));
//
//
// // 点击事件一般都写在绑定数据这里,当然写到上边的创建布局时候也是可以的
// if (mItemClickListener != null){
// holder.itemView.setOnClickListener(new View.OnClickListener() {
// @Override
// public void onClick(View v) {
// // 这里利用回调来给RecyclerView设置点击事件
// mItemClickListener.onItemClick(position);
// }
// });
// }
//
//
// // 给RecyclerView中item中的单独控件设置点击事件 可以直接在adapter中使用setOnClickListener即可
// holder.action_btn.setOnClickListener(new View.OnClickListener() {
// @Override
// public void onClick(View v) {
// Toast.makeText(mContext , item.getButtons() +"position -> "+position , Toast.LENGTH_SHORT).show();
// }
// });
//
//
//
//
// }
@Override
protected void convert(ViewHolder holder, ChannelListResult.DataBean.CategoriesBean.CategoryListBean item, int position) {
/* ViewHolder优化之前 */
// // 绑定数据 首先需要找到 每个子控件
// TextView channel_text = (TextView) holder.itemView.findViewById(R.id.channel_text);
// // 数据在 item里面
// channel_text.setText(item.getName());
//
//
// TextView channel_topic = (TextView) holder.itemView.findViewById(R.id.channel_topic);
// channel_topic.setText(item.getIntro());
//
// ImageView channel_icon = (ImageView) holder.itemView.findViewById(R.id.channel_icon);
// Glide.with(mContext).load(item.getIcon_url()).placeholder(R.drawable.ic_discovery_default_channel).into(channel_icon) ;
//
//
// TextView channel_update_info = (TextView) holder.itemView.findViewById(R.id.channel_update_info);
//
// // 显示数据 因为最下边数据是:左边灰色,右边粉红色,所以这里使用html
// String str = item.getSubscribe_count() + " 订阅 | " +
// "总帖数 " + item.getTotal_updates() + "";
// channel_update_info.setText(Html.fromHtml(str));
/*
* ViewHolder优化之后
* 这里使用getView的方式来减少findViewById的次数
*/
// 绑定数据 首先需要找到 每个子控件
// TextView channel_text = holder.getView(R.id.channel_text);
//
// // 数据在 item里面
// channel_text.setText(item.getName());
//
//
// TextView channel_topic = holder.getView(R.id.channel_topic);
// channel_topic.setText(item.getIntro());
//
// ImageView channel_icon = holder.getView(R.id.channel_icon);
// Glide.with(mContext).load(item.getIcon_url()).placeholder(R.drawable.ic_discovery_default_channel).into(channel_icon) ;
//
//
// TextView channel_update_info = holder.getView(R.id.channel_update_info);
//
// // 显示数据 因为最下边数据是:左边灰色,右边粉红色,所以这里使用html
// String str = item.getSubscribe_count() + " 订阅 | " +
// "总帖数 " + item.getTotal_updates() + "";
// channel_update_info.setText(Html.fromHtml(str));
/*
* 在ViewHolder中设置文本的链式调用
* 比上边方式更加简便,直接把每个TextView控件的id、对应的数据传递过去即可,这里采用的是 链式调用
*/
// 显示数据 因为最下边数据是:左边灰色,右边粉红色,所以这里使用html
String str = item.getSubscribe_count() + " 订阅 | " +
"总帖数 " + item.getTotal_updates() + "";
// 链式调用 一般 Builder设计模式中最常见
holder.setText(R.id.channel_text , item.getName())
.setText(R.id.channel_topic , item.getIntro())
.setText(R.id.channel_update_info , Html.fromHtml(str)) ;
holder.setImagePath(R.id.channel_icon,new ImageLoader(item.getIcon_url())) ;
}
}
注意:
4.1 在Adapter中只去实现构造方法和 convert()方法 ;
4.2 在构造方法中直接添加 对应的item的布局文件,在 convert()方法中直接使用holder.setText()给对应文本和图片设置数据即可;
具体代码随后会上传至github