造轮子系列,自己动手封装RecycylerView

关于RecyclewView,相信大家都比较熟悉了。在日常开发中很常见的一个控件。如果对RecyclerView还不是很熟悉的话,推荐你去参考鸿洋大神的博客。今天我们的目的不仅仅只是使用recyclerView,更重要的是,为recyclerView添加一些比较常见的功能,也简单化我们的recyclerView的使用。

首先,贴一张效果图放这里。

gif4.gif

要实现上面的效果,如果只是使用RecyclerView的话,实现比较比较麻烦。所以,我就上面的效果封装起来,以便使用起来更加方便。下面是使用说明。

首先第一步,添加引用:在Projectbuilde.gradle添加如下依赖:

compile 'reoger.hut.com.strrecyclerview:Rrecyclerview:1.0.0'

为RecyclerView添加适配器Adapter

在同一般的adapter不同的是,这里我们需要继承RBaseAdapter其中的MyAdapter.ViewHolderPer是我们为适配器绑定的布局类,主要代码如下:

class ViewHolderPer extends RBaseViewHolder {
    public ImageView imageView;
    public TextView mName;

    public ViewHolderPer(View itemView) {
            super(itemView);
            imageView = (ImageView) itemView.findViewById(R.id.image);
            mName = (TextView) itemView.findViewById(R.id.name);
        }

        @Override
        public void onBindViewHolder(int position) {
        imageView.setImageResource(datas.get(position).getIds());
            mName.setText(datas.get(position).getName());
        }

        //点击事件可以在这里进行实现
        @Override
        public void OnItemClick(View view, int position) {
            Toast.makeText(mContext,"点击了"+position,Toast.LENGTH_SHORT).show();
        }
    }

可以看到MyAdapter.ViewHolderPer继承了RBaseViewHolder,并且在ViewHolderPer中实现findViewById逻辑,然后在onBindViewHolder绑定布局,设置要显示的数据。最后,然后需要添加点击事件,可以在OnItemClick实现点击逻辑。

接下来,在adapter中的示例代码如下:

    private List datas;
    private LayoutInflater mInflater;
    private Context mContext;
    public MyAdapter(List datas, Context context) {
        this.datas = datas;
        mInflater = LayoutInflater.from(context);
        mContext =  context;
    }

    public void loadMoreData(List datas){
        this.datas = datas;
      notifyDataSetChanged();
    }
    @Override
    public void addHeaderView(View headerView) {
        mHeaderView = headerView;
        notifyItemInserted(0);
    }
    @Override
    public void addFooterView(View footerView) {
        mFooterView = footerView;
        if(isLoadMoreFooterShown)
            notifyItemInserted(Item_Count-2);
        else
            notifyItemInserted(Item_Count-1);
    }

    @Override
    protected RBaseViewHolder onCreateNormalViewHolder(ViewGroup parent, int viewType) {
        View v = mInflater.inflate(R.layout.item_list,parent,false);
        ViewHolderPer per = new ViewHolderPer(v);
        return per;
    }



    @Override
    protected int getDataCount()
    {
        return datas.size();
    }


    /**
     * 如果需要实现删除效果,在这里进行实现
     * @param position 要删除对象的索引号
     */
    @Override
    public void onSwiped(int position) {
        if(datas !=null&&datas.size()>=position){
            if(HeaderView)//如果添加了header的话,需要将header的位置也算在里面
                datas.remove(position-1);
            else
                datas.remove(position);
            notifyItemRemoved(position);
        }
    }


    /**
     * 如果需要实现拖拽的效果,在这里实现数据交换
     * @param srcPosition 选中的viewHolder
     * @param targerPostion 目标对象
     * @return true 表示消耗此次的点击事件
     */
    @Override
    public boolean onMove(int srcPosition, int targerPostion) {
        if(datas != null){
                if(HeaderView){
                    Collections.swap(datas,srcPosition-1,targerPostion-1);
                }else
                    Collections.swap(datas,srcPosition,targerPostion);
                notifyItemMoved(srcPosition,targerPostion);
    }
        return true;
}

相信理解上面的代码没有什么难度,特殊的地方已经添加了注释。注意:如果需要添加Header或者Footer的话,在adapter中直接copy上面的代码就好了。至于为什么要这么写,可以参考后面的博客。至于里面的Per,是我们定义的一个数据对象类,主要代码如下:

public class Per {
    private int ids;
    private String name;

    public int getIds() {
        return ids;
    }

    public void setIds(int ids) {
        this.ids = ids;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

}

内容简单,不做解释了,如果想看adapter中完整的内容,可以点击这里.
对了,这里在贴一下item_list的代码:这里实现的是item的布局



    
    
    
    

最后,在MainActivity中进行引用

在布局中引用我们的布局:




   


然后,先直接将MainActivity中的代码完全贴出来,里面的代码也是比较简单的。

package reoger.hut.com.testuser;

import android.os.Bundle;
import android.os.Handler;
import android.support.v7.app.AppCompatActivity;
import android.support.v7.widget.LinearLayoutManager;
import android.support.v7.widget.RecyclerView;
import android.view.LayoutInflater;
import android.view.View;

import java.util.ArrayList;
import java.util.List;

import reoger.hut.com.strrecyclerview.RPullRecycler;
import reoger.hut.com.strrecyclerview.houchHelper.MyItemTouchHelper;
import reoger.hut.com.strrecyclerview.myDecoraltion.RDividerItemDecoration;
import reoger.hut.com.testuser.adapter.MyAdapter;
import reoger.hut.com.testuser.bean.Per;

import static reoger.hut.com.strrecyclerview.utils.Utils.CanTouchCurrentItem;
import static reoger.hut.com.testuser.R.layout.footer_view;
import static reoger.hut.com.testuser.R.layout.header_view;

public class MainActivity extends AppCompatActivity implements RPullRecycler.OnRecyclerRefreshListener, RPullRecycler.OnRecyclerLongPressClick {

    private RPullRecycler mpullRecycler;

    private MyAdapter myAdapter;
    private List datas;
    private LinearLayoutManager manager;
    private MyItemTouchHelper itemTouchHelper;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        manager = new LinearLayoutManager(this,LinearLayoutManager.VERTICAL,false);
       // manager = new GridLayoutManager(this,2);
        initData();
    }

    private void initData() {
        mpullRecycler = (RPullRecycler) findViewById(R.id.pullclerView);
        mpullRecycler.setLayoutManager(manager);//设置这个必须放在setAdapter之前
        myAdapter = new MyAdapter(getData(),this);
        mpullRecycler.setOnRefreshListener(this);//添加滑动监听,主要用于下拉刷新和上拉加载的监听
        mpullRecycler.setRecyclerLongPressClick(this);//添加移动item的监听事件

        mpullRecycler.setAdapter(myAdapter);
        mpullRecycler.enableLoadMore(true);//设置可以上拉加载,默认不拉不可以加载
        mpullRecycler.enablePullToRefresh(true);//设置可以下拉刷新,默认下拉刷新

        itemTouchHelper = new MyItemTouchHelper(myAdapter);//添加移动Item的监听器
        itemTouchHelper.attachToRecyclerView(mpullRecycler);
        itemTouchHelper.setSwipeEnable(true);//设置可以删除

        View v = LayoutInflater.from(this).inflate(header_view,mpullRecycler,false);
        myAdapter.addHeaderView(v);//添加headView
        View v2 = LayoutInflater.from(this).inflate(footer_view,mpullRecycler,false);
        myAdapter.addFooterView(v2);//添加footerView

        //添加分割线,默认系统效果。如果需要实现自己的效果,可以在
        mpullRecycler.addItemDecoration(new RDividerItemDecoration(this, RDividerItemDecoration.VERTICAL));//添加间隔

    }


    private List getData(){
        datas = new ArrayList<>();
        int []ids ={R.mipmap.img1,R.mipmap.img2,R.mipmap.img3,R.mipmap.img4};
        String []names ={"占山","历史","王五","斩六"};
        for(int j=0;j<2;j++)
            for(int i=0;i<4;i++){
                Per item = new Per();
                item.setIds(ids[i]);
                item.setName(names[i]);
                datas.add(item);
            }
        return datas;
    }

    /**
     * 下拉与上拉刷新的回调
     * @param action ACTION_PULL_TO_REFRESH 上拉
     *               ACTION_LOAD_MORE_REFRESH 下拉
     */
    @Override
    public void onRefresh(int action) {
        if(action == RPullRecycler.ACTION_PULL_TO_REFRESH){
            new Handler().postDelayed(new Runnable() {
                @Override
                public void run() {
                   myAdapter.loadMoreData(loadData());
                    mpullRecycler.onRefreshCompleted();
                }
            },3000);
        }
        if(action == RPullRecycler.ACTION_LOAD_MORE_REFRESH){//模拟延时加载
            new Handler().postDelayed(new Runnable() {
                @Override
                public void run() {
                    mpullRecycler.onRefreshCompleted();
                }
            },3000);
        }
    }

    private List loadData(){
        for(int i=0;i<4;i++){
            Per item = new Per();
            item.setName("新增的"+i);
            datas.add(0,item);
        }
        return datas;
    }

    /**
     * 移动Item的实现
     * @param vh 参照示例写即可
     */
    @Override
    public void onSwipAndDrag(RecyclerView.ViewHolder vh) {
        if(CanTouchCurrentItem(vh))
        itemTouchHelper.startDrag(vh);
    }
}

具体实现以及说明代码和注释已经比较明显了,就不多做说明了。不过要记得继承两个接口RPullRecycler.OnRecyclerRefreshListener, RPullRecycler.OnRecyclerLongPressClick.
OnRecyclerRefreshListener实现对上拉、下拉的监听。
OnRecyclerLongPressClick实现对item长按移动的监听。
到此,我们完成了上面效果图的全部代码。是不是很简单。
赶快去试试把。

总结

通过我自己简单封装的RrecycylerView可以比较简易的实现下面的功能效果‘

  1. 简单实现上拉下拉刷新
  2. 简单实现点击事件
  3. 简单实现右滑删除
  4. 简单添加head和footer
  5. 简单实现添加item之间的间隔。
    如果你对里面的具体实现过程感兴趣,可以参考我的下一篇博客。也可以直接访问我的github查看源代码。

end

你可能感兴趣的:(造轮子系列,自己动手封装RecycylerView)