RecyclerView的使用解析

1.概述

RecyclerView是从Android 5.0开始谷歌推出一个用于展示大量数据的新控件，用以替换传统的ListView控件。它具有高度的解耦、异常的灵活性和更高的效率，通过设置它提供的不同的LayoutManager、ItemDecoration、ItemAnimator可以实现丰富多彩的效果。

2.使用方法

2.1 添加依赖

PS:Android28之后谷歌不再推荐使用v7包，故使用如下新的导入方式

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation 'androidx.appcompat:appcompat:1.1.0'
    implementation group: 'androidx.recyclerview', name: 'recyclerview', version: '1.1.0'
}

2.2 新建布局文件

1.此处布局文件（recycler_view_list.xml）为提供给RecyclerView中每个item使用的样式文件。例子比较简单，只在布局文件中添加了一个TextView，想要炫酷的效果可自行设计。

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="wrap_content">

    <TextView
        android:id="@+id/list_item"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:gravity="center"/>

</RelativeLayout>

2.在要使用RecyclerView的布局文件中添加RecyclerView控件

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/layout_main"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

    <androidx.recyclerview.widget.RecyclerView
        android:id="@+id/my_recycler_view"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />

</RelativeLayout>

2.3 新建ViewHolder类继承RecyclerView.ViewHolder

public class MyViewHolder extends RecyclerView.ViewHolder {

    TextView textView;

    MyViewHolder(@NonNull View itemView) {
        super(itemView);
        textView = itemView.findViewById(R.id.list_item);
    }
}

2.4 新建Adapter类继承RecyclerView.Adapter

public class MyAdapter extends RecyclerView.Adapter {

    private Context context;

    private MyViewHolder viewHolder;

    private ArrayList<String> list;

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

    @NonNull
    @Override
    public RecyclerView.ViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
        // 此处建议inflate方法传两个参数，即第二个参数传null
        // 如果使用三个参数的inflate方法（即第二个参数传parent）的情况下，recycler_view_list布局文件的layout_width和layout_height方法一般不能同时为match_parent
        // 因为这样会使单个item占满整个RecyclerView，导致只能显示一个item，需要滑动才能显示其他item
        viewHolder = new MyViewHolder(LayoutInflater.from(context).inflate(R.layout.recycler_view_list, parent, false));
        return viewHolder;
    }

    @Override
    public void onBindViewHolder(@NonNull RecyclerView.ViewHolder holder, int position) {
        // 在onBindViewHolder方法中无法使用子类ViewHolder对象作为参数
        System.out.println("MyAdapter position:" + position);
        viewHolder.textView.setText(list.get(position));
    }

    @Override
    public int getItemCount() {
        // 此方法一定要重写，否则recyclerView不显示，通常是返回list.size()
        // onBindViewHolder中的position从此方法的返回值中取得
        System.out.println("MyAdapter list.size():" + list.size());
        return list.size();
    }
}

2.5 在项目中使用

public class MainActivity extends AppCompatActivity {

    private RecyclerView recyclerView;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        ArrayList<String> list = new ArrayList<>();
        for (int i = 0; i < 10; i++) {
            list.add(String.valueOf(i));
        }
        RecyclerView.LayoutManager layoutManager = new LinearLayoutManager(this);
        MyAdapter adapter = new MyAdapter(this, list);
        recyclerView = findViewById(R.id.my_recycler_view);
        recyclerView.setLayoutManager(layoutManager);
        recyclerView.setAdapter(adapter);
    }
}

3.实现效果

image.png

4.总结

4.1 使用方法总结

虽然有adapter的存在让使用显得略微复杂了一些，但是抽象起来看整个过程就是往adapter里填充viewHolder，再往recyclerView中填充adapter而已。

4.2 踩坑总结

1.getItemCount()方法一定要重写！！！
此方法不重写则RecyclerView完全无法展示，且onCreateViewHolder和onBindViewHolder方法完全不会被调用。
2.recyclerView使用时一定要调用setLayoutManager()及setAdapter()方法
3.在重写的onCreateViewHolder方法中，调用inflate方法往viewHolder中填充布局时，要注意布局文件的layout_width和layout_height属性值（详情见代码注释）。因为AS新建的布局文件默认值都是match_parent，搞得我找了好久才找到原因！！！
4.RecyclerView只提供了DividerItemDecoration作为默认的分割线，复杂效果需要手动继承RecyclerView.ItemDecoration来自定义分割线，同时列表中各个条目的点击事件也需要自定义实现。

5.后记

这是个人的第一篇博客，开博客的目的也只是为了强化自己对于知识点的理解和记忆，并在以后遇到类似问题的时候能及时找到解决办法。本人对安卓的理解和掌握也还不深刻，希望大家理解。
多的不说了，控制自己，掌控敌人，加油！！！