Android RecyclerView比较常用的使用方法总结

（点击上方目录可以跳转）
转载请注明出处：http://blog.csdn.net/htwhtw123/article/details/77917403
1.一般的RecyclerView（和一些注意事项）
2.下拉后从上端刷新
3.上拉从下端刷新
4.添加尾部首部分别添加footer和Head
项目Demo放在gihub上了，4个module是此博文的4个情况下的实例：点击跳转

1.一般的RecyclerView（和一些注意事项）

(在demo中是名为Normal的module)
1.首先需要导入RecyclerView,下面给两种方法，任选一种（方法一是导入包的共有方法，感觉导入官方包时更加常用）
（1）方法一：ctrl+shift+alt+s->左端点击需要导入RecyclerViewd的module->右上端点击Dependencies标签->点击最右端加号：“+”
->library dependency->搜索框输入recyclerView后回车->双击以“com.android.“开头的一项->OK
（2）方法二：在module的build.gradle中的dependencies {}中添加下面一句后点击Android Studio右上角出现的Sync Now。

compile 'com.android.support:recyclerview-v7:26.0.0-alpha1'

2.布局文件，没有什么特殊的

<android.support.v7.widget.RecyclerView
        android:id="@+id/recyclerView"
        android:layout_width="match_parent"
        android:layout_height="match_parent"/>

3.列表子项的布局，一定要注意，最外层的控件高度不是match_parent，而是子项需要有的高度，否则一个子项就会占据整个屏幕。这里就放了一个textView，其实想放什么控件都可以，在适配器里面，这些对象都是可以获取的，在那里怎么设置都可以。这里通过android:layout_marginTop=”4dp”，实现子项间有4dp的间隔，可以通过设置颜色，实现recyclerView的分隔线（当然还有更加正规的方法）。下面是item_layout的全部代码。

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
              android:orientation="vertical"
              android:layout_marginTop="4dp"
              android:background="@android:color/white"
              android:layout_width="match_parent"
              android:layout_height="wrap_content">

    <TextView
        android:id="@+id/textView"
        android:textSize="30sp"
        android:padding="5dp"
        android:layout_gravity="center"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="TextView"/>
</LinearLayout>

4.RecyclerView的适配器需要重写，可以依照自己的需求修改，这里写一个常用的，并可以对recyclerView数据添加、删除、清空的适配器。下面直接放ItemAdapter里的代码：

public class ItemAdapter extends RecyclerView.Adapter<ItemAdapter.MyViewHolder> {

    List<String> list;//存放数据
    Context context;

    public ItemAdapter(List<String> list, Context context) {
        this.list = list;
        this.context = context;
    }

    @Override
    public MyViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
        MyViewHolder holder = new MyViewHolder(LayoutInflater.from(context).inflate(R.layout.item_layout, parent, false));
        return holder;
    }

    //在这里可以获得每个子项里面的控件的实例，比如这里的TextView,子项本身的实例是itemView，
// 在这里对获取对象进行操作
    //holder.itemView是子项视图的实例，holder.textView是子项内控件的实例
    //position是点击位置
    @Override
    public void onBindViewHolder(MyViewHolder holder,final  int position) {
    //设置textView显示内容为list里的对应项
        holder.textView.setText(list.get(position));
        //子项的点击事件监听
        holder.itemView.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View view) {
                Toast.makeText(context, "点击子项"+position, Toast.LENGTH_SHORT).show();
            }
        });
    }

//要显示的子项数量
    @Override
    public int getItemCount() {
        return list.size();
    }

    //这里定义的是子项的类，不要在这里直接对获取对象进行操作
    public class MyViewHolder extends RecyclerView.ViewHolder {

        TextView textView;

        public MyViewHolder(View itemView) {
            super(itemView);
            textView = itemView.findViewById(R.id.textView);
        }
    }

    /*之下的方法都是为了方便操作，并不是必须的*/

    //在指定位置插入，原位置的向后移动一格
    public boolean addItem(int position, String msg) {
        if (position < list.size() && position >= 0) {
            list.add(position, msg);
            notifyItemInserted(position);
            return true;
        }
        return false;
    }

    //去除指定位置的子项
    public boolean removeItem(int position) {
        if (position < list.size() && position >= 0) {
            list.remove(position);
            notifyItemRemoved(position);
            return true;
        }
        return false;
    }

    //清空显示数据
    public void clearAll() {
        list.clear();
        notifyDataSetChanged();
    }

5.Activity里的代码：RecyclerView的三部曲：获取recyclerView对象、添加布局管理器、添加适配器。适配器要重写，可以事先放入数据，也可以之后添加数据。注意，这里导入包是import android.support.v7.widget.RecyclerView; 不要导入另一个。

 RecyclerView recyclerView = (RecyclerView) findViewById(R.id.recyclerView);//获取对象
        recyclerView.setLayoutManager(new LinearLayoutManager(this));//设置布局管理器，这里选择用竖直的列表
        List<String> list = new ArrayList<>();
        for (int i = 0; i < 15; i++) {
            list.add("" + i);
        }
        ItemAdapter itemAdapter=new ItemAdapter(list, this);//添加适配器，这里适配器刚刚装入了数据
        recyclerView.setAdapter(itemAdapter);
        //itemAdapter.addItem(1,"123");
        //itemAdapter.removeItem(15);
        //itemAdapter.clearAll();

2.下拉后从上端刷新

(在demo中是名为PullDownRefresh的module)
下拉从上端刷新，这个比较简单。在布局文件里，用SwipeRefreshLayout把RecyclerView包在里面，然后再在java代码里面写下拉的响应事件就好了。下面直接写代码：
1.布局文件，把RecyclerView放在SwipeRefreshLayout里：

<android.support.v4.widget.SwipeRefreshLayout
        android:id="@+id/srl"
        android:layout_width="match_parent"
        android:layout_height="match_parent">

        <android.support.v7.widget.RecyclerView
            android:id="@+id/rv"
            android:layout_width="match_parent"
            android:layout_height="match_parent"/>

2.java代码：

  //列表
        recyclerView= (RecyclerView) findViewById(R.id.rv);
        recyclerView.setLayoutManager(new LinearLayoutManager(this));
        //添加数据
        list=new ArrayList<>();
        for (int i = 0; i < 10; i++) {
            list.add("第"+i+"项");
        }
        adapter=new ItemAdapter(list,this);
        recyclerView.setAdapter(adapter);

        //下拉加载控件
        swipeRefreshLayout= (SwipeRefreshLayout) findViewById(R.id.srl);
        swipeRefreshLayout.setColorSchemeColors(Color.BLUE);//设置旋转圈的颜色
        //下拉监听
        swipeRefreshLayout.setOnRefreshListener(new SwipeRefreshLayout.OnRefreshListener() {
            @Override
            public void onRefresh() {
                list.add(0,"下拉加载出现的："+i++);
                adapter.notifyDataSetChanged();
                swipeRefreshLayout.setRefreshing(false);//设置成true的话，下拉过后就会一直在那里转
            }
        });

(在demo中是名为PullUpRefresh的module)

3.上拉从下端刷新

设置一个监听器，在上拉到开始显示最下面一项时，加载更多项。
监听器EndLessOnScrollListener代码：

public abstract class EndLessOnScrollListener extends RecyclerView.OnScrollListener {

    private static final String TAG = "EndLessOnScrollListener";

    LinearLayoutManager linearLayoutManager;

    //当前所在页
    private int currentPage=0;

    //已经加载出来的item数
    private int totalItemCount=0;

    //用来存储上一个totalItemCount
    private int previousTotal=0;

    //屏幕可见的item数量
    private int visibleItemCount;

    //屏幕可见第一个Item的位置
    private int firstVisibleItem;

    //是否上拉数据
    private boolean loading=true;

    public EndLessOnScrollListener(LinearLayoutManager linearLayoutManager) {
        this.linearLayoutManager = linearLayoutManager;
    }

    @Override
    public void onScrolled(RecyclerView recyclerView, int dx, int dy) {
        super.onScrolled(recyclerView, dx, dy);

        visibleItemCount=recyclerView.getChildCount();
        totalItemCount=linearLayoutManager.getItemCount();
        firstVisibleItem=linearLayoutManager.findFirstVisibleItemPosition();
//去掉loading也可以，但是性能会下降，在每次滑动时都会判断，所以的加上
        if(loading){
            Log.d(TAG, "firstVisibleItem: " + firstVisibleItem);
            Log.d(TAG, "totalItemCount:" + totalItemCount);
            Log.d(TAG, "visibleItemCount:" + visibleItemCount);
            Log.d(TAG, "currentPage:" + currentPage);
            if(totalItemCount>previousTotal){
                //说明数据项已经加载结束
                loading=false;
                previousTotal=totalItemCount;
            }
        }
        //实际效果是滑动到已加载页最后一项可见的瞬间，添加下一页
        if(!loading&&totalItemCount-visibleItemCount<=firstVisibleItem){
            currentPage++;
            onLoadMore(currentPage);
            loading=true;
        }

    }

    /**
     * 提供一个抽闲方法，在Activity中监听到这个EndLessOnScrollListener
     * 并且实现这个方法
     * 这个方法在可见的页的最后一项，可见时调用
     * currentPage是加载到的页面编号
     */
    public abstract void onLoadMore(int currentPage);

给recyclerview添加上拉监听事件即可，这里我让它每次加5项：

  recyclerView.addOnScrollListener(new EndLessOnScrollListener(linearLayoutManager) {
            @Override
            public void onLoadMore(int currentPage) {
                for (int i = count; i < 5+count; i++) {
                    list.add("上拉加载"+i);
                }
                adapter.notifyDataSetChanged();
                count+=5;
            }
        });

4.添加尾部首部分别添加footer和Head

(在demo中是名为HeaderAndFooter的module)
实现方法，主要是在适配器里实现。要在适配器必须写的方法里面和getItemViewType()方法里，考虑可能最前和最后一项分别是header和footer情况。

1.temAdapter里的代码

    private static final int TYPE_HEADER = 0;
    private static final int TYPE_FOOTER = 1;
    private static final int TYPE_NORMAL = 2;


    public ItemAdapter(List<String> list, Context context) {
        this.list = list;
        this.context = context;
    }

    @Override
    public MyViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
        if (headerView != null && viewType == TYPE_HEADER) {
            return new MyViewHolder(headerView);
        }
        if (footerView != null && viewType == TYPE_FOOTER) {
            return new MyViewHolder(footerView);
        }

        MyViewHolder holder = new MyViewHolder(LayoutInflater.from(context).
                inflate(R.layout.item_layout, parent, false));
        return holder;
    }

    @Override
    public void onBindViewHolder(MyViewHolder holder, final int position) {
        if (getItemViewType(position) == TYPE_NORMAL) {
            holder.tv.setText(list.get(position - 1));
            return;
        } else if (getItemViewType(position) == TYPE_HEADER) {
            return;
        } else
            return;
    }

    /**
     * 重写这个方法，很重要，是加入Header和Footer的关键，我们通过判断item的类型，从而绑定不同的view
     */
    @Override
    public int getItemViewType(int position) {
        if (headerView == null && footerView == null) {
            return TYPE_NORMAL;
        }
        if (position == 0) {
            //第一个item应该加载Header
            return TYPE_HEADER;
        }
        if (position == getItemCount() - 1) {
            //最后一个,应该加载Footer
            return TYPE_FOOTER;
        }
        return TYPE_NORMAL;
    }

    @Override
    public int getItemCount() {
        if (headerView == null && footerView == null) {
            return list.size();
        } else if (headerView == null && footerView != null) {
            return list.size() + 1;
        } else if (headerView != null && footerView == null) {
            return list.size() + 1;
        } else {
            return list.size() + 2;
        }
    }

    public View getHeaderView() {
        return headerView;
    }

    public void setHeaderView(View headerView) {
        this.headerView=headerView;
        notifyItemInserted(0);
    }

    public View getFooterView() {
        return footerView;
    }

    public void setFooterView(View footerView) {
        this.footerView=footerView;
        notifyItemInserted(getItemCount()-1);
    }

    class MyViewHolder extends RecyclerView.ViewHolder {

        TextView tv;

        public MyViewHolder(View itemView) {
            super(itemView);
            tv = itemView.findViewById(R.id.tv);
        }
    }

活动里面的代码：

RecyclerView recyclerView;
    ItemAdapter adapter;
    List<String>list;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        initView();
    }
 private void initView() {
        list= new ArrayList<>();
        for (int i = 0; i < 10; i++) {
            list.add("第"+i+"项");
        }
        adapter=new ItemAdapter(list,this);

        recyclerView= (RecyclerView) findViewById(R.id.rv);
        recyclerView.setAdapter(adapter);
        recyclerView.setLayoutManager(new LinearLayoutManager(this));
        //注意，以下两个方法必须在setAdapter()之后调用，否则长和宽会变成wrap_content
        addHeader();
        addFooter();

    }

    private void addHeader(){
        View header= LayoutInflater.from(this).inflate(R.layout.header_layout,recyclerView,false);
        adapter.setHeaderView(header);
    }

    private  void addFooter(){
        View footer= LayoutInflater.from(this).inflate(R.layout.footer_layout,recyclerView,false);
        adapter.setFooterView(footer);
    }