真实项目运用-RecyclerView封装

原文链接：从零开始搭建android框架系列
项目地址：MVPCommon

前言

很久没有发表从零开始搭建android框架系列这个系列的文章了 。由于最近工作确实有点忙碌，也在脚踏实地的花时间研究android方面自己很多不懂的东西。但是写博客确实是一个坚持不懈和自我提高的过程，也希望在保持文章更新的同时能够保持文章的质量 。之前翻译了一些文章，有兴趣的小伙伴可以去看一下。今天这篇文章来谈一谈RecyclerView的封装，对RecyclerView的一些使用点进行总结，以及如何将RecyclerView的adapter进一步简化。平时开发使用的RecyclerView Adapter是来自鸿洋大神的为RecyclerView打造通用Adapter 让RecyclerView更加好用以及对应的github项目baseAdapter github.但是有个问题是他这篇文章写的时间比较早，项目一直在维护，所以本篇文章也算是对整个项目的思路的再梳理。
刚好解决了昨天在鸿洋博客下看到的这个小问题。哈哈。希望对大家有帮助。

项目结构

首先看看我的项目结构，项目分为common 和module模块，这里对之前整个项目的框架进行了改造，没有了之前的library，取而代之的是将所有公用组件放在了common包中，这是每个项目都可以copy使用的部分。在module包中就是具体每个项目的每个模块。比如这个示例项目中，包含

recyclerView组件作为每个项目中都可以使用的组件，这里放在common-widgets-recyclerview包下。

这里可以看到的recyclerView组件这里添加了adapter，base，divider，section，utils，wrapper包。下面来进行深入的讲解以及怎样在项目开发中进行使用吧。

RecyclerView基础

RecyclerView is a more advanced and flexible version of ListView. This widget is a container for large sets of views that can be recycled and scrolled very efficiently. Use the RecyclerView widget when you have lists with elements that change dynamically. 
RecyclerView 是Android L版本中新添加的一个用来取代ListView的SDK，它的灵活性与可替代性比listview更好。RecyclerView与ListView原理是类似的：都是仅仅维护少量的View并且可以展示大量的数据集。在RecyclerView标准化了ViewHolder类似于ListView中convertView用来做视图缓存。

请直接参考 Android RecyclerView 使用完全解析 体验艺术般的控件

ViewHolder

ViewHolder是google在优化ListView性能的技巧上就提到的，虽然google并没有强制使用，但事实上它已经成为ListView的编写规范。在RecyclerView上,ViewHolder的使用成为了一种强制手段了。接下来对封装的ViewHolder进行分析：
首先来看看ViewHolder的用法，这是一个简单的获取String数组并展现到TextView上。通过数组的大小来创建item的数量。

public class MyAdapter extends RecyclerView.Adapter<MyAdapter.ViewHolder> {
   
   
    public String[] datas = null;
    public MyAdapter(String[] datas) {
        this.datas = datas;
    }
    //创建新View，被LayoutManager所调用
    @Override
    public ViewHolder onCreateViewHolder(ViewGroup viewGroup, int viewType) {
        View view = LayoutInflater.from(viewGroup.getContext()).inflate(R.layout.item,viewGroup,false);
        ViewHolder vh = new ViewHolder(view);
        return vh;
    }
    //将数据与界面进行绑定的操作
    @Override
    public void onBindViewHolder(ViewHolder viewHolder, int position) {
        viewHolder.mTextView.setText(datas[position]);
    }
    //获取数据的数量
    @Override
    public int getItemCount() {
        return datas.length;
    }
    //自定义的ViewHolder，持有每个Item的的所有界面元素
    public static class ViewHolder extends RecyclerView.ViewHolder {
   
   
        public TextView mTextView;
        public ViewHolder(View view){
        super(view);
            mTextView = (TextView) view.findViewById(R.id.text);
        }
    }
}

当然这里只是简单的一个TextView，但是当数据多起来之后，很多TextView，ImageView，以及代码段

View view = LayoutInflater.from(viewGroup.getContext()).inflate(R.layout.item,viewGroup,false); 
ViewHolder vh = new ViewHolder(view);

都可以进行稍微修改。现在ViewHolder修改如下：

public class ViewHolder extends RecyclerView.ViewHolder {
   
   
    private SparseArray<View> mViews;
    private View mConvertView;
    private Context mContext;

    ImageLoaderUtil imageLoaderUtil;


    public ViewHolder(Context context, View itemView) {
        super(itemView);
        mContext = context;
        mConvertView = itemView;
        mViews = new SparseArray<>();
        imageLoaderUtil = new ImageLoaderUtil();
    }


    public static ViewHolder createViewHolder(Context context, View itemView) {
        return new ViewHolder(context, itemView);
    }

    public static ViewHolder createViewHolder(Context context,
                                              ViewGroup parent, int layoutId) {
        View itemView = LayoutInflater.from(context).inflate(layoutId, parent,
                false);
        return new ViewHolder(context, itemView);
    }


    /**
     * 通过viewId获取控件
     *
     * @param viewId
     * @return
     */
    public <T extends View> T getView(int viewId) {
        View view = mViews.get(viewId);
        if (view == null) {
            view = mConvertView.findViewById(viewId);
            mViews.put(viewId, view);
        }
        return (T) view;
    }

    public View getConvertView() {
        return mConvertView;
    }


    /****以下为辅助方法*****/

    /**
     * 设置TextView的值
     *
     * @param viewId
     * @param text
     * @return
     */
    public ViewHolder setText(int viewId, String text) {
        TextView tv = getView(viewId);
        tv.setText(text);
        return this;
    }

    public ViewHolder setImageResource(int viewId, int resId) {
        ImageView view = getView(viewId);
        view.setImageResource(resId);
        return this;
    }

    public ViewHolder setImageUrl(int viewId, String url) {
        ImageView view = getView(viewId);
        ImageLoader.Builder builder = new ImageLoader.Builder();
        ImageLoader img = builder.url(url)
                .imgView(view).strategy(ImageLoaderUtil.LOAD_STRATEGY_ONLY_WIFI).build();
        imageLoaderUtil.loadImage(mContext, img);
        return this;
    }

    public ViewHolder setImageBitmap(int viewId, Bitmap bitmap) {
        ImageView view = getView(viewId);
        view.setImageBitmap(bitmap);
        return this;
    }

    public ViewHolder setImageDrawable(int viewId, Drawable drawable) {
        ImageView view = getView(viewId);
        view.setImageDrawable(drawable);
        return this;
    }
......
......

    /**
     * 关于事件的
     */
    public ViewHolder setOnClickListener(int viewId,
                                         View.OnClickListener listener) {
        View view = getView(viewId);
        view.setOnClickListener(listener);
        return this;
    }

......


}

这里需要关注的是getView方法，直接返回当前view的类型。
所以我们可以在使用viewholder的时候

holder.setText(R.id.text_view, "text");

就完成了textView的setText操作。而没有进行类型转换。当然这里省去了findViewById的步骤的同时，使用private SparseArray<View> mViews 进行所有view的保存，也就是在牺牲一定内存性能的情况下，确保了代码的整洁性。还需要关注上面的

    public ViewHolder setImageUrl(int viewId, String url) {
        ImageView view = getView(viewId);
        ImageLoader.Builder builder = new ImageLoader.Builder();
        ImageLoader img = builder.url(url)
                .imgView(view).strategy(ImageLoaderUtil.LOAD_STRATEGY_ONLY_WIFI).build();
        imageLoaderUtil.loadImage(mContext, img);
        return this;
    }

这里只需要传入ImageView的id，和url就可以解析网络图片并完成加载。使用的是Glide进行图片加载。具体可以参考之前的文章网络图片加载的封装.这样封装还有一个好处是当你遇到奇葩的服务器返回字段，比如说我们前段时间遇到的每次返回的textView的text都是有问题的，需要我们自己处理，比如说时间需要截取并返回刚刚，几小时前，我们都可以在ViewHolder进行统一的处理，而不需要在每个数据获取的时候进行处理。

多Item布局实现

这也是我们使用RecyclerView和ListView中过程中经常遇到的问题。看看网易新闻的列表样式，顶部大图，标题+三张图片，标题+左侧图片，视频样式，广告样式……. 这种情况我们怎么便捷快速处理呢？

看看通常处理itemView的type类型不同的方法：

public class MyAdapter extends RecyclerView.Adapter<RecyclerView.ViewHolder> {
   
   
    class ViewHolder0 extends RecyclerView.ViewHolder {
        ...
    }

    class ViewHolder2 extends RecyclerView.ViewHolder {
        ...
    }

    @Override
    public int getItemViewType(int position) {
        // Just as an example, return 0 or 2 depending on position
        // Note that unlike in ListView adapters, types don't have to be co