github源码地址：https://github.com/zhou-you/EasyXRecyclerView

万能适配器Adapter功能介绍

RecyclerView适配器的传统使用方法是继承RecyclerView.Adapter<RecyclerView.ViewHolder>相信大家都很清楚（不清楚的请先自行学习官方使用方式），这里为什么提供一种万能适配器呢？主要是方便快捷的开发，一种最佳偷懒姿势，打造属于RecyclerView的万能适配器Adapter和ViewHolder、以及更简单方便的数据绑定和操作。

特性

• 优化了Adapter代码，减少了代码量
• 简单配置、无需重写额外方法
• 添加Item事件
• • Item的点击事件
• • Item的长按事件
• 添加列表加载动画
• • 一行代码轻松切换5种默认动画
• 支持添加分组
• • 随心定义分组头部、尾部
• • 支持点击展开收起
• • 支持配置是否带组头或组尾（组头、组尾是否显示）
• • 子项为Grid（并支持Span不同）
• • 头、尾、子项支持多种类型
• • 支持分组带有Sticky黏性效果
• • 分组增加状态页面占位显示（加载中、错误页面、空页面、内容页面）
• 自定义不同的item类型
• 支持添加item拖拽
• 支持自定义ViewHolder，让开发者随心所欲

主要相关类介绍

注：
1.主要推荐用法是 HelperRecyclerViewAdapter+HelperRecyclerViewHolder完美打造万能适配器，其它可根据具体需求自由选择适配器。
2.类名HelpXXX开头和GroupedXXX相关的类用方法差别较大，请看提供的具体demo用法
3.使用适配器时在Activity和Fragment等中不需要再创建一个集合用于存放数据，适配器里面已经默认内置装载数据的集合List<T>，否则会有两个集合占用内存,从网络返回的数据是集合可以直接丢进适配器里面。

HelperRecyclerViewAdapter支持的数据操作接口介绍

HelperRecyclerViewAdapter是继承于BaseRecyclerViewAdapter同时实现了DataHelper数据操作接口，在使用中会更加简单快捷，具体如下：

注：
1.需要先调用setListAll(List<T> datas)或者从适配器构造方法里装载数据后，再允许操作其它方法。
2.使用以上提供的方法，里面都有做空指针和索引越界判断，外部不管集合或者数据data是否为null都可传递.不会导致应用崩溃。
3.使用以上所有方法有不用再调用notifyDataSetChanged()方法刷新适配器了，方法里面会自动帮你触发刷新通知。

万能适配器使用介绍

/**
 * <p>描述：自定义适配器（请大家重点参考此类的使用方式和讲解）</p>
 * 
 * 一下代码会提供四种设置数据的构造<br/>
 * 本代码模拟采用方式四来举例，其实也是方式二的一个变种，大部分适配器都是对应一个item布局。<br/>
 * 传统的写法请参考：OldMyAdapter.java<br/>
 * 作者： zhouyou<br>
 * 日期： 2016/10/27 16:24<br>
 * 版本： v2.0<br>
 */
public class MyAdapter extends HelperRecyclerViewAdapter<TestBean> {
    //以下提供适配器的几种构造使用方式，请选择自己喜欢的【一种】运用方式就可以了
    /*
    //方式一 data layoutId都从外部传入，例如：new MyAdapter(mList,this,R.layout.item)
    //注意layoutIds是表示可变参数，支持传入多个布局，用于支持多item布局，例如：new MyAdapter(mList,this,R.layout.item，R.layout.item2)
    public MyAdapter(List<TestBean> data, Context context, int... layoutIds) {
        super(data, context, layoutIds);
    }
    //方式二 layoutIds从外部传入，例如：MyAdapter  adapter = new MyAdapter(this,R.layout.item),数据传递用adapter.setListAll(mList);
    //注意layoutIds是表示可变参数，支持传入多个布局，用于支持多item布局，例如：new MyAdapter(this,R.layout.item，R.layout.item2)
    public MyAdapter(Context context, int... layoutIds) {
        super(context, layoutIds);
    }
    
    //方式三 数据从外部传入，布局直接写在里面（推荐使用方式），好处把适配器相关的item布局都放在本来中一块管理
    public MyAdapter(List<TestBean> mList, Context context) {
        super(mList, context,R.layout.item);//单item布局
        //super(mList, context,R.layout.item,R.layout.item2);//多item布局
    }*/

    //方式四 布局直接通过在构造方法中设置（推荐使用方式），数据集合通过setListAll设置
    public MyAdapter(Context context) {
        super(context, R.layout.item);
    }

   //不需要自己再自定义viewHolder类了 库里定义有viewHolder基类HelperRecyclerViewHolder
    @Override
    protected void HelperBindData(HelperRecyclerViewHolder viewHolder, int position, TestBean item) {
        /****1.数据获取方式*****/
        //旧：传统的写法是从集合中获取再强转,如下：
        //TestBean testBean =(TestBean)datas.get(position);
        //新：baseadapter中提供的有获取当前postion位置对应的数据，直接调用就行了，也不用强转
        final TestBean testBean = getData(position);

        /****2.view赋值*****/
        //方式一：采用链式的设计的书写方式，一点到尾。（方式一）
        viewHolder.setText(R.id.text,testBean.getName())
                .setImageResource(R.id.image, MakePicUtil.makePic(position))
               /* .setVisible(R.id.text,true);//设置某个view是否可见*/
        .setOnClickListener(R.id.image, new View.OnClickListener() {//点击事件
            @Override
            public void onClick(View view) {
                Toast.makeText(mContext, "我是子控件" + testBean.getName() + "请看我如何处理View点击事件的", Toast.LENGTH_LONG).show();
            }
        });
        //其它更多连写功能请查看viewHolder类中代码
        
        //方式二：不采用链式的方式，通过getView直接获取控件对象，不需要强转了，采用的是泛型
        TextView textView =viewHolder.getView(R.id.text2);
        textView.setText(testBean.getAge());

        /****3.其它更多使用方式，请自己探索*****/
        //举例如果想知道适配器中数据是否为空用isEmpty()就可以了，无需list.size()==0  list.isEmpty()等其它方式
        if(isEmpty()){
            
        }
    }

    /*******************以下两种item点击事件都可以，自己选择合适的方式**********************************/
    //方式一：此方式是另一种处理：绑定相关事件,例如点击长按等,默认空实现，如果你要使用需要覆写setListener()方法
    //方式二：绑定相关事件,例如点击长按等,默认空实现等我们一般会在适配器外部使用，
    // 例如： mAdapter.setOnItemClickListener(new BaseRecyclerViewAdapter.OnItemClickListener<TestBean>(){});
    
   /* @Override
    protected void setListener(HelperRecyclerViewHolder viewHolder, final int position, TestBean item) {
        viewHolder.getItemView().setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View view) {
                Toast.makeText(mContext,"我是Item："+position,Toast.LENGTH_SHORT).show();
            }
        });
    }*/
   
}

Activity/Fragment中引用：

//用框架里面的adapter时不需要再建立全局集合存放数据了，数据都和adapter绑定了，里面自带泛型集合
//如果你外面还建立一个集合，那相当于占用内存两份了。。
List<TestBean> listData = new ArrayList<TestBean>();

//方式四对应的初始化适配器   也可采用下面的构造方式创建对象  （自己选择）
//这种方式一定要先setAdapter然后才setListAll（）设置数据
mAdapter = new MyAdapter(this);
mRecyclerView.setAdapter(mAdapter);

/****讲解*****/
//1.使用setListAll（覆盖数据）后就不需要再调用notifyDataSetChanged（）
//2.如果是addAll()追加
//3.自己会刷新
//4.如果集合List<TestBean>是从网络请求中返回的，那么此处就不需要再多创建new ArrayList<TestBean>()操作，直接在网络请求你成功的地方调用mAdapter.setListAll（list）；
mAdapter.setListAll(listData);

//方式一对应的初始化适配器
//mAdapter = new MyAdapter(listData, this, R.layout.item);
//方式二对应的初始化适配器
//mAdapter = new MyAdapter(this, R.layout.item);

多Item布局使用介绍

/**
 * <p>描述：多item适配器</p>
 *
 * 作者： zhouyou<br>
 * 日期： 2016/10/31 16:24<br>
 * 版本： v2.0<br>
 */
public class MultiItemAdapter extends com.zhouyou.recyclerview.adapter.HelperRecyclerViewAdapter<MultipleItemBean> {

    public MultiItemAdapter(Context context) {
        //设置多item布局adapter_multi_item1_layout，adapter_multi_item2_layout，adapter_multi_item3_layout
        super(context, R.layout.adapter_multi_item1_layout,R.layout.adapter_multi_item2_layout,R.layout.adapter_multi_item3_layout);
    }

    @Override
    protected void HelperBindData(HelperRecyclerViewHolder viewHolder, int position, MultipleItemBean item) {
        //方式一，对应checkLayout中的方式一
        if(item.getItemType() == 0){//adapter_multi_item1_layout布局对应的操作
            viewHolder.setText(R.id.name_tv,item.getName());
        } else if(item.getItemType() == 1){//adapter_multi_item2_layout布局对应的操作
            viewHolder.setText(R.id.name_tv,item.getName())
                    .setText(R.id.info_tv,item.getAge());
        }

        /*//方式二，对应checkLayout中的方式二
        int layoutType = getItemViewType(position);
        if(layoutType==R.layout.adapter_multi_item1_layout){
            viewHolder.setText(R.id.name_tv,item.getName());
        }else if(layoutType==R.layout.adapter_multi_item2_layout){
            viewHolder.setText(R.id.name_tv,item.getName())
                    .setText(R.id.info_tv,item.getAge());
        }*/
    }

    /*********多item布局使用方式***********/
    //如果要用多item布局，必须重写checkLayout()方法，来指定哪一条数据对应哪个item布局文件
    //不重写的时候返回默认是0，也就是只会加载第一个布局
    @Override
    public int checkLayout(MultipleItemBean item, int position) {
        //方式一：判断的类型直接写在model中
        return item.getItemType();
        //方式二：根据类型判断
        /*if(item instanceof A){
            return R.layout.adapter_multi_item1_layout;
        }else if(item instanceof B){
            return R.layout.adapter_multi_item2_layout;
        }else {
            return R.layout.adapter_multi_item3_layout;
        }*/
    }
}

添加Item事件

//1.设置item事件监听
//2.在适配器MyAdapter类中也可以设置点击事件，采用setListener()接口
mAdapter.setOnItemClickListener(new BaseRecyclerViewAdapter.OnItemClickListener<TestBean>() {
    @Override
    public void onItemClick(View view, TestBean item, int position) {
        Toast.makeText(getApplicationContext(),"我是item "+position,Toast.LENGTH_LONG).show();
    }
});

//长按事件
mAdapter.setOnItemLongClickListener(new BaseRecyclerViewAdapter.OnItemLongClickListener() {
    @Override
    public void onItemLongClick(View view, Object item, int position) {
        Toast.makeText(getApplicationContext(),"我是item长按 "+position,Toast.LENGTH_LONG).show();
    }
});

Item拖拽使用介绍

适配器需要继承HelperRecyclerViewDragAdapter,同样具备所有万能适配器的功能。

/**
 * <p>描述：item可以移动拖拽的适配器</p>
 *
 *
 * 作者： zhouyou<br>
 * 日期： 2016/10/31 16:24<br>
 * 版本： v2.0<br>
 */
public class DragAdapter extends HelperRecyclerViewDragAdapter<String> {
    public DragAdapter(Context context) {
        super(context, R.layout.adapter_draggable_layout);
    }

    @Override
    protected void HelperBindData(HelperRecyclerViewHolder viewHolder, int position, String item) {
        viewHolder.setText(R.id.tv,item).setImageResource(R.id.image, MakePicUtil.makePic(position));
    }
}

Activity/Fragment中引用：

//拖动监听事件
OnItemDragListener listener = new OnItemDragListener() {
    @Override
    public void onItemDragStart(RecyclerView.ViewHolder viewHolder, int pos) {
        //开始拖动
    }

    @Override
    public void onItemDragMoving(RecyclerView.ViewHolder source, int from, RecyclerView.ViewHolder target, int to) {
        //拖动中
    }

    @Override
    public void onItemDragEnd(RecyclerView.ViewHolder viewHolder, int pos) {
        //拖动结束
    }
};

DragAdapter mAdapter = new DragAdapter(this);
//适配器绑定item拖动监听
ItemDragListener mItemDragAndSwipeCallback = new ItemDragListener(mAdapter);
//触摸帮助类
ItemTouchHelper mItemTouchHelper = new ItemTouchHelper(mItemDragAndSwipeCallback);
//绑定RecyclerView
mItemTouchHelper.attachToRecyclerView(mRecyclerView);
//设置允许拖动的方向
mItemDragAndSwipeCallback.setDragMoveFlags(ItemTouchHelper.LEFT | ItemTouchHelper.RIGHT | ItemTouchHelper.UP | ItemTouchHelper.DOWN);
//设置监听
mAdapter.enableDragItem(mItemTouchHelper);
mAdapter.setOnItemDragListener(listener);

//item点击事件
mAdapter.setOnItemClickListener(new BaseRecyclerViewAdapter.OnItemClickListener<String>() {
    @Override
    public void onItemClick(View view, String item, int position) {
        Toast.makeText(DragActivity.this,item,Toast.LENGTH_SHORT).show();
    }
});
//设置适配器
mRecyclerView.setAdapter(mAdapter);
mAdapter.setListAll(mData);

Item动画使用介绍

适配器需要继承HelperRecyclerViewAnimAdapter,同样具备所有万能适配器的功能。

/**
 * <p>描述：具有动画效果的适配器</p>
 *
 * 作者： zhouyou<br>
 * 日期： 2016/10/31 16:24<br>
 * 版本： v2.0<br>
 */
public class AnimationAdapter extends HelperRecyclerViewAnimAdapter<String> {

    public AnimationAdapter(Context context) {
        super(context, R.layout.adapter_animation_layout);
    }
    @Override
    protected void HelperBindData(HelperRecyclerViewHolder viewHolder, int position, Object item) {
        
    }
}

Activity/Fragment中引用：

AnimationAdapter mAdapter = new AnimationAdapter(this);
mAdapter.setShowItemAnimationEveryTime(true);//是否每次都会执行动画,默认是false,该方便测试
mAdapter.setItemAnimation(AnimationType.ALPHA);//设置item动画类型ALPHA、SCALE、SLIDE_FROM_LEFT、SLIDE_FROM_RIGHT、SLIDE_FROM_BOTTOM
//mAdapter.setCustomItemAnimator(new CustomAnimator());//自定义实现动画
//mAdapter.setItemAnimationDuration(2000);//设置动画执行时间
//mAdapter.setItemAnimationInterpolator(new AccelerateInterpolator());//设置动画插值器

superRecyclerView.setAdapter(mAdapter);
mAdapter.setListAll(dataList);//设置数据

状态页面适配器介绍

状态页面适配器主要是解决列表页面具有加载中页面、空页面、错误页面、内容页面之间无缝切换的问题。通常的做法是用一个普通的占位页面和Recyclerview布局平级，通过显示和隐藏等来改变占位页面达到效果。这里尝试另一种方式来解决此问题，在适配器中实现具体的getEmptyView，getErrorView，getLoadingView,虽然多了几个方法，但是代码更整洁清晰了，也利于你想定制任意的页面状态，根据调用的方法动态监控类表的数据装载情况才显示出占位图，有列表内容显示的时候占位图不会被加载不会占用内存。

/**
 * <p>描述：状态页面适配器</p>
 * 1.实现具体的getEmptyView，getErrorView，getLoadingView,虽然多了几个方法，但是代码更整洁清晰了，也利于你想定制任意的页面状态<br>
 * 2.如果你的每个页面状态都是一样的，不想每个页面都去实现getEmptyView，getErrorView，getLoadingView，可以自己再封装一个baseAdapter,处理公共的状态页面<br>
 * 作者： zhouyou<br>
 * 日期： 2018/1/19 17:51 <br>
 * 版本： v1.0<br>
 */
public class EmptyStateAdapter extends HelperStateRecyclerViewAdapter<String> {
    public EmptyStateAdapter(List data, Context context, int... layoutId) {
        super(data, context, layoutId);
    }

    public EmptyStateAdapter(Context context) {
        super(context, R.layout.header_footer_item);
    }

    //不需要自己再自定义viewHolder类了 库里定义有viewHolder基类HelperRecyclerViewHolder
    @Override
    protected void HelperBindData(HelperRecyclerViewHolder viewHolder, int position, String item) {
        final String value = getData(position);
        viewHolder.setText(R.id.test_btn, value);
    }

    @Override
    public View getEmptyView(ViewGroup parent) {
        //空页面内容布局
        return mLInflater.inflate(R.layout.view_state_empty, parent, false);
    }

    @Override
    public View getErrorView(ViewGroup parent) {
        //错误页面布局
        return mLInflater.inflate(R.layout.view_state_error, parent, false);
    }

    @Override
    public View getLoadingView(ViewGroup parent) {
        //加载中页面布局
        return mLInflater.inflate(R.layout.view_state_loading, parent, false);
    }

    //onBindEmptyViewHolder、onBindErrorViewHolder、onBindLoadingViewHolder根据需要进行选择是否实现。
    @Override
    public void onBindEmptyViewHolder(HelperRecyclerViewHolder holder) {
        //修改空页面内容
        holder.setText(R.id.tv_empty_view, "我更新了空页面内容");
    }

    
   /* @Override
    public void onBindErrorViewHolder(HelperRecyclerViewHolder holder) {
        super.onBindErrorViewHolder(holder);
    }*/

   /* @Override
    public void onBindLoadingViewHolder(HelperRecyclerViewHolder holder) {
        super.onBindLoadingViewHolder(holder);
    }*/
}

在需要的地方，通过一些方法来控制页面的显示。

mAdapter = new EmptyStateAdapter(this);
mRecyclerView.setAdapter(mAdapter);

//以下状态在需要的地方调用
mAdapter.setState(HelperStateRecyclerViewAdapter.STATE_LOADING);//模拟加载中
//mAdapter.setState(HelperStateRecyclerViewAdapter.STATE_ERROR);
//mAdapter.setState(HelperStateRecyclerViewAdapter.STATE_EMPTY);
//如果页面列表集合有内容调用mAdapter.setListAll(list);时会自动隐藏占位图
mAdapter.setListAll(list);
//如果设置了 mAdapter.setState()调用：mAdapter.clear();/mAdapter.remove()等都会自动切换到占位图


//如果用网格Manager,必须用StateGridLayoutManager，否则Grid状态页面会不起作用
StateGridLayoutManager layoutManager = new StateGridLayoutManager(this,3);
//切记！切记！切记！
//setLayoutManager方法一定要放在setAdapter之后，否则LayoutManager是GridLayoutManager的时候尾部脚显示错误
mRecyclerView.setLayoutManager(layoutManager);

注：
1.如果用网格Manager,必须用StateGridLayoutManager，否则Grid状态页面会不起作用
2.setLayoutManager方法一定要放在setAdapter之后，否则LayoutManager是GridLayoutManager的时候尾部显示错误,切记！切记！切记！

分组显示

主要采用GroupedRecyclerViewAdapter可以很方便的实现RecyclerView的分组显示，并且每个组都可以包含组头、组尾和子项；可以方便实现多种Type类型的列表，可以实现如QQ联系人的列表一样的列表展开收起功能，还可以实现头部悬浮吸顶功能等。
示例：

public class GroupedListAdapter extends GroupedRecyclerViewAdapter<GroupBean> {
    public GroupedListAdapter(Context context) {
        super(context);
    }

    public GroupedListAdapter(Context context, List<GroupBean> list) {
        super(context, list);
    }

    //返回组的数量
    @Override
    public int getGroupCount() {
        return getGroups().size();
    }

    //返回当前组的子项数量
    @Override
    public int getChildrenCount(int groupPosition) {
        return getGroup(groupPosition).getChildren().size();
    }
    //当前这个组是否有头部
    @Override
    public boolean hasHeader(int groupPosition) {
        return true;
    }

    //当前这个组是否有尾部
    @Override
    public boolean hasFooter(int groupPosition) {
        return true;
    }

    //返回头部的布局id。(如果hasHeader返回false，这个方法不会执行)
    @Override
    public int getHeaderLayout(int viewType) {
        return R.layout.adapter_header;
    }

    //返回尾部的布局id。(如果hasFooter返回false，这个方法不会执行)
    @Override
    public int getFooterLayout(int viewType) {
        return R.layout.adapter_footer;
    }

    //返回子项的布局id。
    @Override
    public int getChildLayout(int viewType) {
        return R.layout.adapter_child;
    }

    //绑定头部布局数据。(如果hasHeader返回false，这个方法不会执行)
    @Override
    public void onBindHeaderViewHolder(HelperRecyclerViewHolder holder, int groupPosition, GroupBean item) {
        //也可以通过Group获取
        //GroupEntity entity =getGroup(groupPosition);
        holder.setText(R.id.tv_header, item.getHeader());
    }

    //绑定尾部布局数据。(如果hasFooter返回false，这个方法不会执行)
    @Override
    public void onBindFooterViewHolder(HelperRecyclerViewHolder holder, int groupPosition, GroupBean item) {
        holder.setText(R.id.tv_footer, item.getFooter());
    }

    //绑定子项布局数据。
    @Override
    public void onBindChildViewHolder(HelperRecyclerViewHolder holder, int groupPosition, int childPosition, GroupBean item) {
        holder.setText(R.id.tv_child, item.getChildren().get(childPosition).getChild());
    }
}

还可是重写GroupedRecyclerViewAdapter方法实现头、尾和子项的多种类型item。

//返回头部的viewType。
public int getHeaderViewType(int groupPosition);

//返回尾部的viewType。
public int getFooterViewType(int groupPosition) ;

//返回子项的viewType。
public int getChildViewType(int groupPosition, int childPosition) ;

设置点击事件的监听

GroupedListAdapter adapter = new GroupedListAdapter(this, GroupModel.getGroups(10, 5));
adapter.setOnHeaderClickListener(new com.zhouyou.recyclerview.group.GroupedRecyclerViewAdapter.OnHeaderClickListener<GroupBean>() {
    @Override
    public void onHeaderClick(com.zhouyou.recyclerview.group.GroupedRecyclerViewAdapter adapter, HelperRecyclerViewHolder holder, int groupPosition, GroupBean item) {
    }
});
adapter.setOnFooterClickListener(new com.zhouyou.recyclerview.group.GroupedRecyclerViewAdapter.OnFooterClickListener<GroupBean>() {
    @Override
    public void onFooterClick(com.zhouyou.recyclerview.group.GroupedRecyclerViewAdapter adapter, HelperRecyclerViewHolder holder,
                              int groupPosition, GroupBean item) {
    }
});
adapter.setOnChildClickListener(new com.zhouyou.recyclerview.group.GroupedRecyclerViewAdapter.OnChildClickListener<GroupBean>() {
    @Override
    public void onChildClick(com.zhouyou.recyclerview.group.GroupedRecyclerViewAdapter adapter, HelperRecyclerViewHolder holder,
                             int groupPosition, int childPosition, GroupBean item) {
    }
});
rvList.setAdapter(adapter);

注：
1.setLayoutManager()必须放在setAdapter之前，切记！切记！切记！
2.更多功能使用讲解请参考本库demo中使用示例或者参考donkingliang的github，此模块功能是集成作者的，在此非常感谢，同时也处理了对XRecyclerview的兼容、能够做到分组也支持刷新和加载更多，同时新增支持：追加状态页面的分组效果（请看demo）。