RecyclerView的详细使用步骤

背景

刚开始学习安卓，有些东西老是记不住，所以决定写我的第一篇博客，记录一下最近学的东西！

RecyclerView的基本用法

首先在build.gradle中添加依赖库，书上写的是用compile编译，但是新版的Android Studio改成了用implementation了。
打开app/build.gradle文件，在dependencies闭包中添加Recyclerview的support库，即以下代码中的第六行。

dependencies {
    implementation fileTree(dir: "libs", include: ["*.jar"])
    implementation 'androidx.appcompat:appcompat:1.1.0'
    implementation 'androidx.constraintlayout:constraintlayout:1.1.3'
    //noinspection GradleCompatible
    implementation 'com.android.support:recyclerview-v7:24.2.1'
    testImplementation 'junit:junit:4.12'
    androidTestImplementation 'androidx.test.ext:junit:1.1.1'
    androidTestImplementation 'androidx.test.espresso:espresso-core:3.2.0'
}

修改完成后点击Sync Now进行同步。
接下来在activity_main.xml中添加recyclerview布局，书上用的是android.support.v7.widget.RecyclerView，但是我好像也用不了，从编译器自动跳出来的选项里面选了这个androidx.recyclerview.widget.RecyclerView，书好像比较旧了，好多都更新了。

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

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

</LinearLayout>

下面以书上水果的例子说明用法，先定义水果的类：

package com.example.recyclerviewtest;

public class Fruit {
    private String name;
    private int imageId;
    public Fruit(String name, int imageId){
        this.name=name;
        this.imageId=imageId;
    }
    public String getName(){
        return name;
    }
    public int getImageId(){
        return imageId;
    }
}

name为水果的名字，imageId为水果对应图片的资源id。
然后建立recyclerview子项布局fruit_item.xml。就是像这样的一个布局，左边是水果的图片，图片旁边是水果名称。二参构造函数，Fruit(name,imageId),初始化数据。

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

    <ImageView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:id="@+id/photo"/>

    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="center_vertical"
        android:layout_marginLeft="10dp"
        android:id="@+id/name"/>

</LinearLayout>

接下来新建一个适配器的类FruitAdapter，继承自RecyclerView.Adapter，指定泛型为FruitAdpater.ViewHolder.

import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.ImageView;
import android.widget.TextView;
import androidx.annotation.NonNull;
import androidx.recyclerview.widget.RecyclerView;
import java.util.List;

public class FruitAdapter extends RecyclerView.Adapter<FruitAdapter.ViewHolder> {
    private List<Fruit> mFruitList;

    static class ViewHolder extends RecyclerView.ViewHolder{
        ImageView fruitImage;
        TextView fruitName;

        public ViewHolder(@NonNull View itemView) {
            super(itemView);
            fruitImage = (ImageView) itemView.findViewById(R.id.photo);
            fruitName = (TextView) itemView.findViewById(R.id.name);
        }
    }
    public FruitAdapter(List<Fruit> fruitList){
        mFruitList=fruitList;
    }
    @NonNull
    @Override
    public FruitAdapter.ViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
        View view = LayoutInflater.from(parent.getContext()).inflate(R.layout.fruit_item, parent, false);
        ViewHolder holder = new ViewHolder(view);
        return holder;
    }

    @Override
    public void onBindViewHolder(@NonNull FruitAdapter.ViewHolder holder, int position) {
        Fruit fruit = mFruitList.get(position);
        holder.fruitName.setText(fruit.getName());
        holder.fruitImage.setImageResource(fruit.getPhoto());
    }

    @Override
    public int getItemCount() {
        return mFruitList.size();
    }
}

ViewHolder是一个内部类，相当于一个容器，将控件暂时的保存，不用每次都去获取，可以提高代码的运行效率。它继承自RecyclerView.ViewHolder，在构造函数中要传入一个参数View,一般是RecyclerView的最外层布局，并且在构造函数中获取布局的控件实例。
接下来是FruitAdapter的构造函数，传入数据源FruitList(装有所有水果的数据)。
由于FruitAdapter继承自RecyclerView.Adapter，那么必须重写onCreateViewHolder()、onBindViewHolder()、getItemCount()三个方法。onCreateViewHolder()参数：方法用于把fruit_item.xml布局加载到父布局中，然后创建一个ViewHolder实例，把布局放入ViewHolder容器中。onBindViewHolder()参数：ViewHoler实例和当前位置position，用于给当前被滑动到屏幕内的子项赋值。用position参数获取当前项的Fruit实例，然后把值传入ViewHolder中，返回ViewHolder实例。getItemCount()用于返回子项的个数。
准备好适配器后，就可以开始使用了，在MainActivity中使用RecyclerView.

package com.example.fruittablet;

import androidx.appcompat.app.AppCompatActivity;
import androidx.recyclerview.widget.LinearLayoutManager;
import androidx.recyclerview.widget.RecyclerView;
import android.os.Bundle;
import java.util.ArrayList;
import java.util.List;

public class MainActivity extends AppCompatActivity {
    private List<Fruit> fruitList = new ArrayList<>();

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        initFruits();
        RecyclerView recyclerView = findViewById(R.id.recycle_view);
        LinearLayoutManager layoutManager = new LinearLayoutManager(this);
        recyclerView.setLayoutManager(layoutManager);
        FruitAdapter adapter = new FruitAdapter(fruitList);
        recyclerView.setAdapter(adapter);
    }
    private void initFruits(){
        for (int i=0;i<2;i++){
            Fruit apple = new Fruit("Apple", R.drawable.apple);
            fruitList.add(apple);
            Fruit banana = new Fruit("Banana", R.drawable.banana);
            fruitList.add(banana);
            Fruit orange = new Fruit("Orange", R.drawable.orange);
            fruitList.add(orange);
            Fruit watermelon = new Fruit("Watermelon", R.drawable.watermelon);
            fruitList.add(watermelon);
            Fruit pear = new Fruit("Pear", R.drawable.pear);
            fruitList.add(pear);
            Fruit grape = new Fruit("Grape", R.drawable.grape);
            fruitList.add(grape);
            Fruit pineaplle = new Fruit("Pineapple", R.drawable.pineapple);
            fruitList.add(pineaplle);
            Fruit strawberry = new Fruit("strawberry", R.drawable.strawberry);
            fruitList.add(strawberry);
            Fruit mango = new Fruit("Mango", R.drawable.mango);
            fruitList.add(mango);
        }
    }
}

initFruits()方法，初始化水果数据，Fruit apple=new Fruit(“Apple”,R.drawable.apple_pic);将数据放入列表fruitList.add(apple).获取之前创建的RecyclerView实例recycler_view，然后创建一个LinearLayoutManager实例，他代表RecyclerView的布局，默认是垂直布局(如果想要实现水平布局可以添加一句layoutManger.setOrientation(LinearLayoutManager.HORIZONTAL);）
用setLayoutManager()来设置布局。接下来创建FruitAdapter实例，将存有水果数据的fruitList传入FruitAdapter的构造函数中。最后调用setAdapter()方法实现适配器的设置。
这样整个例子就完成啦！我们来运行一下)😉

总结一下，

1. 添加库，创建RecyclerView布局，对应activity_main.xml
2. 创建关于recyclerview子项信息的类，对应Fruit类
3. 创建子项布局文件，对应fruit_item.xml
4. 创建适配器：
   a、封装子类控件，对应ViewHolder
   b、传入数据源，对应FruitAdapter
   c、加载子项布局，对应onCreateViewHolder
   d、给子项控件赋值，对应onBindViewHolder
   e、获取子项长度，对应getItem
5. 使用RecyclerView
   a、创建RecyclerView实例，找到之前创建的recycler_view.xml
   b、创建布局实例LinearLayoutManager
   c、setLayoutManager()设置recyclerview的布局
   d、创建适配器实例FruitAdapter,将数据源传入构造函数
   e、setAdapter()设置适配器。