通用RecylerAdapter，内置XRecyclerView，兼容上下拉与动画，高复用，一个Adapter通用全部页面，支持空页面，懒人专属

时间 2019-11-17

标签通用 recyleradapter 内置 xrecyclerview 兼容下拉动画一个 adapter 全部页面支持懒人专属栏目职业生涯繁體版

原文原文链接

　Hello你们好，郭老司机又来了。之前都是看文章的小喵同志，现在终于体也会到码字的不易，做为一个沉默寡言的程序猿，对于码文无数的前辈深表敬佩((/- -)/。

　
这是欢迎各位践踏的Github：github.com/CarGuojavascript

　RecylerView相信你们都听过(你肯定要说没听过 = =)，在ListView横行的年代里，RecyclerView携带了褒贬不一的评价，开始进入了咱们的视线，那时候恰好开始了新的项目，正好就拿它练手了。下方进入介绍使用流程，建议对着Demo撸起来。( ･᷄-･᷅ )git

　正常状况下，对于每个不一样的列表，咱们常常须要实现不一样的Adapter ，来处理对应的逻辑，这样致使了咱们有着许多重复的代码，在优化代码（懒）这种动力的驱动下，我的实现了一个通用的Adapter。后面所说的Holder，能够理解为列表中一个Item，属于它的逻辑处理类，每一种类型的Item有一种Holder。github

　只须要一个Adapter，你就能够实现各类类型的列表，在一个列表里兼容不一样类型的Item，你须要作的，仅仅是维护你的Holder（相似List里的一个Item）和Model，无需再关心其余，实现高复用与多样式逻辑，外带支持自定义动画，多种上下拉实现方式，不须要再写任何Adapter代码(^o^)/。api

一、 CommonRecyclerManager ：绑定layoutId和你的Holder类名。
　这个管理类是用于绑定Holder和R.layout.xxx，这样在后面CommonRecyclerAdapter 用它经过数据Model的layoutId，找到对应的Holder并建立它。ide

//将布局的ID和holder类型关联
commonRecyclerManager.addType(TextHolder.ID, TextHolder.class.getName());复制代码

二、 RecyclerBaseHolder ：继承这个Holder，实现你的需求。
　RecyclerBaseHolder的全部Holder的基类，他继承了RecyclerView.ViewHolder，并定义写两个方法，因此你继承它就对了，在createView的时候找到控件，在onBind读取数据填充画面。这里就是实现你梦想的地方！布局

//实现的hodler继承RecyclerBaseHolder，重载下面方式实现你的需求
public class TextHolder extends RecyclerBaseHolder {
    //布局id，通常我习惯吧这个Holder须要处理的id都写在这里，方便管理
    public final static int ID = R.layout.text_item;
    @BindView(R.id.item_text)
    TextView itemText;

    public TextHolder(Context context, View v) {
        super(context, v);
    }    

    //view建立好了
    @Override 
    public void createView(View v) {
        ButterKnife.bind(this, v);
    }

    //view建立好了，更具数据处理逻辑
    @Override
    public void onBind(RecyclerBaseModel model, int position) {
        //转化为你的model
        TextModel textModel = (TextModel) (model);
        itemText.setText(textModel.getText());
    }

    //不须要能够不写
    @Override
    public AnimatorSet getAnimator(View view) {
        //实现你的动画
        return null;
    }
}复制代码

三、 CommonRecyclerAdapter ：通用的适配器
　只须要传入数据List和CommonRecyclerManager，就会根据Model的顺序，经过数据的layoutId，在RecyclerView中自动生成对应的Holder，其余的功能只须要简单的配置便可。post

//用数据和manager建立
adapteradapter = new CommonRecyclerAdapter(getActivity(), commonRecyclerManager, datas);

//支持须要加载更多
adapter.setNeedLoadMore(true);

//支持空数据显示 空页面
adapter.setShowNoData(true);

//设置item显示动画支持打开
adapter.setNeedAnimation(true);复制代码

四、RecyclerBaseModel ：数据model的积累，必须继承它，不离不弃。
　继承它的做用是，由于整个Adapter都是以它为基类，你须要继承他，最终的是，你须要这个Model对应的布局Id，这样它才能找到属于本身的Holder。优化

//继承RecyclerBaseModel实现你须要的数据类型
public class TextModel extends RecyclerBaseModel {
    private String text = "";

    public String getText() {
        return text;
    }

    public void setText(String text) {
        this.text = text;
    }
}复制代码

总结起来就是

　
一、实现你的Holder并继承RecyclerBaseHolder，这里是你实现需求的地方，至关于Item的逻辑。动画

二、让你的数据model继承RecyclerBaseModel，设置Model的LayoutId(很重要)，这样model就会经过CommonRecyclerManager，找到LayoutId对应关联的Holder，并生成它。

三、你须要一个CommonRecyclerManager来绑定你的LayoutId和处理这布局的Holder类名。

四、经过CommonRecyclerManager和Model的数据列表生成CommonRecyclerAdapter。

五、把Adapter交给Recycler。

　逻辑看起来是否是有些复杂？其实就是model的LayoutId，CommonRecyclerManager经过关联了处理它的Holder。这样咱们只须要在数据List里，根据数据设置不一样的LayoutId的model，Adapter就会自动匹配对应的Holder。

　如此一来，<(￣︶￣)>你只须要实现好Holder和组装好Model，任何列表均可以使用起来，不须要再写Adapter逻辑了。根据model的顺序，Adapter自动生成对应的Holder，而且同一个Holder是能够绑定不一样的LayoutId，之后你只须要维护和兼容你的Holder，在各个列表里通用的你holder逻辑了，是否是瞬间代码干净了好多？

下拉刷新与上拉加载更多

　
普通的列表，直接使用系统的SwipeRefreshLayout就能够啦，简单有好用。下拉加载更多直接添加下方方法，轻松实现上下拉刷新<(￣︶￣)，简单粗暴，就是记得要加个锁避免重复进入。

//打开支持须要加载更多
adapter.setNeedLoadMore(true);

recycler.addOnScrollListener(new LoadMoreScrollListener() {
    @Override
    public void onLoadMore() {
        //注意加锁
        if (!isLoadMore) {
            isLoadMore = true;
            recycler.postDelayed(new Runnable() {
                @Override
                public void run() {
                    isLoadMore = false;
                    loadMore();
                }

            }, 2000);
        }
    }

    //当前第一个可视的是哪一个item
    @Override
    public void onScrolled(int firstPosition) {
    }
});复制代码

其余配置

　
你还能够配置是否显示动画效果，配置上拉loading的颜色，单击和长按等，看下面。

//支持空数据显示 空页面
adapter.setShowNoData(true);

//显示空数据model,不设置显示默认空页面
adapter.setNoDataModel(noDataModel);

//显示空数据页面布局,不设置显示默认，布局id须要经过CommonRecyclerManager关联hodler
adapter.setNoDataLayoutId(noDataLayoutId);

//设置动画支持打开
adapter.setNeedAnimation(true);

//添加点击
adapter.setOnItemClickListener();复制代码

XRecyclerView兼容支持

　这里添加了XRecyclerView，而且对其进行了修改。XRecyclerView内置了内部Adapter，使其支持添加头部，自带上下拉效果的控件，部分调整以后，全面支持CommonRecyclerAdapter。

　不须要监听滑动，不须要SwipeRefreshLayout，轻松添加刷新与加载更多。并且更是支持动态配置，上下拉的各类样式支持，具体在ProgressStyle下有多种类型支持配置，解决了Adapter对瀑布流上拉的支持不够兼容的问题。

　这里使用方式，和普通的RecyclerView同样，支持和CommonRecyclerAdapter的配合，并且它一样支持空页面显示，还支持添加各类头部，惟一须要注意的是，添加分割线类addItemDecoration和点击的时候，须要针对添加了头部，和刷新的绝对的position，换算成相对的位置，此处曾经把本身坑哭了╥﹏╥...，下面看代码吧。

//是否屏蔽下拉
//xRecycler.setPullRefreshEnabled(false);
//上拉加载更多样式，也能够设置下拉
xRecycler.setLoadingMoreProgressStyle(ProgressStyle.SysProgress);
//设置管理器，关联布局与holder类名，不一样id能够管理一个holder
CommonRecyclerManager commonRecyclerManager = new CommonRecyclerManager();
commonRecyclerManager.addType(ImageHolder.ID, ImageHolder.class.getName());
commonRecyclerManager.addType(TextHolder.ID, TextHolder.class.getName());
commonRecyclerManager.addType(ClickHolder.ID, ClickHolder.class.getName());
//初始化通用管理器
commonRecyclerAdapter = new CommonRecyclerAdapter(getActivity(), commonRecyclerManager, dataList);
xRecycler.setAdapter(commonRecyclerAdapter);

ImageView imageView = new ImageView(getActivity());
imageView.setImageResource(R.drawable.xxx1);
imageView.setScaleType(ImageView.ScaleType.CENTER_CROP);
imageView.setMinimumHeight(dip2px(getActivity(), 100));
//添加头部
xRecycler.addHeaderView(imageView);
//自己也支持设置空局部
//xRecycler.setEmptyView();
xRecycler.setLoadingListener(new XRecyclerView.LoadingListener() {
    @Override
    public void onRefresh() {
        xRecycler.postDelayed(new Runnable() {
            @Override
            public void run() {
                xRecycler.refreshComplete();
            }
        }, 2000);
    }

    @Override
    public void onLoadMore() {
        xRecycler.postDelayed(new Runnable() {
            @Override
            public void run() {
                loadMore();
            }
        }, 2000);
    }
});

commonRecyclerAdapter.setOnItemClickListener(new OnItemClickListener() {
    @Override
    public void onItemClick(Context context, int position) {
        //须要减去你的header和刷新的view的数量
        Toast.makeText(getActivity(), "点击了！！　" + (position - 2), Toast.LENGTH_SHORT).show();
    }
});复制代码

最后

　　
　到这里你已经知道了大体的用法了吧。详细的内部实现，能够经过DEMO查看。大体逻辑是 CommonRecyclerManager 关联接layoutId和Holder类名，CommonRecyclerAdapter经过Model的layoutId找到这个Holder，而后用layoutId建立view，把View、position、model传入到Holder里面实现数据填充。所layoutId也是*类型id，注意：

使用的时候切记要给你的model设置setResLayoutId(),这是最容易让人遗忘的。

我叫DEMO：github.com/CarGuo/Lazy…