学习笔记：RecyclerView的使用方法

强大的滚动控件 -  RecyclerView 

RecyclerView可以说是ListView的一个增强版，Android官方也更加推荐使用RecyclerView。相较于ListView，RecyclerView的扩展性更好，ListView只能实现数据纵向滚动的效果，如果想实现横向滚动的话，ListView是做不到的。而且RecyclerView可以很轻松的设置每一个子项里具体某一个控件的点击事件，而ListView想实现类似的功能，就相对比较麻烦了。

目录

RecyclerView的基本用法

1、定义RecyclerView子项的实体类和子项布局

tips：LinearLayout中layout_gravity和gravity属性的区别

2、为要使用的RecyclerView创建一个适配器

tips：Recycler.Adapter中onCreateViewHolder()、onBindViewHolder()和getItemCount()三个重写方法介绍

3、在Activity中使用RecyclerView控件

tips：RecyclerView实现横向滚动的样式

---

RecyclerView的基本用法

1、定义RecyclerView子项的实体类和子项布局

这里我们定义一个左图右文的子项，每个子项有两个属性，水果图片和水果名称

定义左图右文的子项布局fruit_item.xml：

<?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/fruit_image"
        />
    <TextView
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:id="@+id/fruit_name"
        android:layout_gravity="center_vertical"
        android:layout_marginLeft="15dp"
        />

</LinearLayout>

tips：LinearLayout中layout_gravity和gravity属性的区别

关于线性布局LinearLayout，它有两个名称相似的属性，layout_gravity和gravity。layout_gravity和gravity的区别如下：

gravity：设置的是控件/View自身内部元素的对其方式，比如一个TextView，则是设置内部文字的对齐方式。

layout_gravity：设置的是控件/View相对于父容器的对齐方式，比如一个TextView设置layout_gravity属性，则表示这个TextView相对于父容器LinearLayout的对齐方式。

这里要注意的一点是，如果LinearLayout的orientation="vertical"时，layout_gravity只有水平方向的设置才起作用，垂直方向的设置不起作用，即：left、right、center_horizontal是生效的；当LinearLayout的orientation="horizontal"时，layout_gravity只有垂直方向的设置才起作用，水平方向的设置不起作用，即：top、bottom、center_vertical是生效的。这也是为什么有的时候你感觉设置了layout_gravity属性不起作用。

定义子项的实体类Fruit：

包含两个属性：水果名称和图片id

public class Fruit {
    String name;
    int imageId;

    public Fruit(String name, int imageId) {
        this.name = name;
        this.imageId = imageId;
    }

    public String getName() {
        return name;
    }

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

    public int getImageId() {
        return imageId;
    }

    public void setImageId(int imageId) {
        this.imageId = imageId;
    }
}

2、为要使用的RecyclerView创建一个适配器

      创建一个FruitAdapter，继承自RecyclerView.Adapter，并将泛型指定为FruitAdapter.ViewHolder，其中，ViewHolder是在FruitAdapter中定义的一个内部类。代码如下：

public class FruitAdapter extends RecyclerView.Adapter<FruitAdapter.ViewHolder> {
    private List<Fruit> mFruitList;
    private int onC_count = 0;
    private int getV_count = 0;
    private int onB_count = 0;


    //ViewHolder用来定义item子项的布局
    static class ViewHolder extends RecyclerView.ViewHolder{

        TextView fruitNameView;
        ImageView fruitImageView;
        View fruitView;

        public ViewHolder(@NonNull View itemView) {
            super(itemView);
            this.fruitNameView = itemView.findViewById(R.id.fruit_name);
            this.fruitImageView = itemView.findViewById(R.id.fruit_image);
            this.fruitView = itemView;
        }
    }
    //构造函数
    public FruitAdapter(List<Fruit> mFruitList) {
        this.mFruitList = mFruitList;
    }

    //onCreateViewHolder用来设置子项布局及点击事件
    @NonNull
    @Override
    public ViewHolder onCreateViewHolder(@NonNull final ViewGroup parent, int i) {
        onC_count = onC_count + 1;
        Log.d("prance", "onCreateViewHolder: " + onC_count);
        View view = LayoutInflater.from(parent.getContext()).inflate(R.layout.fruit_item, parent, false);
        final ViewHolder viewHolder = new ViewHolder(view);
        viewHolder.fruitNameView.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View view) {
                int position = viewHolder.getAdapterPosition();
                Fruit fruit = mFruitList.get(position);
                Toast.makeText(parent.getContext(), "click fruit name:" + fruit.getName(), Toast.LENGTH_SHORT).show();
            }
        });

        viewHolder.fruitImageView.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View view) {
                int position = viewHolder.getAdapterPosition();
                Fruit fruit = mFruitList.get(position);
                Toast.makeText(parent.getContext(), "click fruit view:" + fruit.getName(), Toast.LENGTH_SHORT).show();
            }
        });
        return viewHolder;
    }

    //onBindViewHolder用来设置滑动中各子项点击和展现的样式
    @Override
    public void onBindViewHolder(@NonNull FruitAdapter.ViewHolder viewHolder, int position) {
        onB_count = onB_count + 1;
        Log.d("prance", "onBindViewHolder: " + mFruitList.get(position).getName() + " " + onB_count);
        Fruit fruit = mFruitList.get(position);
        viewHolder.fruitImageView.setImageResource(fruit.getImageId());
        viewHolder.fruitNameView.setText(fruit.getName());

    }

    @Override
    public int getItemCount() {
        getV_count = getV_count + 1;
//        Log.d("prance", "getItemCount：" + getV_count);
        return mFruitList.size();
    }
}

tips：Recycler.Adapter中onCreateViewHolder()、onBindViewHolder()和getItemCount()三个重写方法介绍

FruitAdapter继承自RecyclerView.Adapter，必须重写三个方法： onCreateViewHolder()、onBindViewHolder()和getItemCount()。其中，

onCreateViewHolder()方法用来创建ViewHolder的实例，也就是设置每个子项的布局和点击事件，它会返回一个ViewHolder的对象。这里需要注意的是，onCreateViewHolder()的目的是创建ViewHolder对象，而ViewHolder作为RecyclerView缓存管理的对象是可以在列表中复用的。也就是说onCreateViewHolder()不一定会随着滑动而一直调用，如果有可以复用的viewHolder（item不可见后回收复用的），则不会调用onCreateViewHolder()方法来创建新的ViewHolder对象。还有一点，在onCreateViewHolder()方法中，我们是可以为ViewHolder对象中每一个具体的控件设置点击事件的。

onBindViewHolder()方法用来为每个子项的数据进行赋值，这个方法在每个子项被展现的时候都会调用，也就是说onBindViewHolder()方法会随着RecyclerView的滑动而一直调用。

getItemCount()方法用来告诉RecyclerView()一共有多少子项。

3、在Activity中使用RecyclerView控件

（1）创建布局文件，添加RecyclerView控件

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

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

</LinearLayout>

（2）在Activity中使用RecyclerView控件

   创建FruitActivity，代码如下：

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

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_fruit_recycleview);
        initFruit();//初始化水果数据
        RecyclerView recyclerView = findViewById(R.id.fruit_recycler_view);
        LinearLayoutManager linearLayoutManager = new LinearLayoutManager(this);
//        linearLayoutManager.setOrientation(LinearLayout.HORIZONTAL); //RecyclerView设置为横向滚动样式
        recyclerView.setLayoutManager(linearLayoutManager);
        FruitAdapter fruitAdapter = new FruitAdapter(fruitList);
        recyclerView.setAdapter(fruitAdapter);
    }

    void initFruit(){
        for (int i = 0; i < 100; i++){
            Fruit apple = new Fruit("apple", R.drawable.apple_pic);
            Fruit banana = new Fruit("banana", R.drawable.banana_pic);
            fruitList.add(apple);
            fruitList.add(banana);
        }
    }
}

tips：RecyclerView实现横向滚动的样式

与ListView使用方法不同的是，这里创建了一个LinearLayout对象，并将它设置到RecyclerView当中。LayoutManager用于指定RecyclerView的布局方式，这里使用的LinearLayoutManager是线性布局的意思，可以实现和ListView类似的效果（没有listview子项之间的网格线）。如果想使用横向滚动的样式，只需要设置linearLayoutManager.setOrientation(LinearLayout.HORIZONTAL)即可。