Android >> 26. RecyclerView（一）

定义Item 子项的内容和布局

先新建一个类，用于描述一个Item 的内部信息：

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;
    }
}

然后为每个Item 子项指定一个自定义的布局，layout 目录下新建一个fruit_item.xml。

<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:id="@+id/fruit_image"
        android:layout_width="100dp"
        android:layout_height="100dp" />

    <TextView
        android:id="@+id/fruit_name"
        android:layout_width="400dp"
        android:layout_height="100dp"
        android:layout_gravity="center"
        android:layout_marginLeft="10dp"
        android:textSize="23dp"/>
</LinearLayout>

dependencies 闭包添加

首先在app/build.gradle 文件中的dependencies 闭包中添加内容：

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation 'androidx.appcompat:appcompat:1.0.2'
    implementation 'androidx.constraintlayout:constraintlayout:1.1.3'
    testImplementation 'junit:junit:4.12'
    androidTestImplementation 'androidx.test:runner:1.2.0'
    androidTestImplementation 'androidx.test.espresso:espresso-core:3.2.0'
    implementation 'com.android.support:mediarouter-v7:29.0.0'
    implementation 'com.android.support:appcompat-v7:29.0.0'
    implementation 'com.android.support:recyclerview-v7:29.0.0'
    implementation 'com.android.support:design:29.0.0'
}

添加RecyclerView 布局

然后在Activity 的layout 布局文件中添加：

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

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

由于RecyclerView 并不是内置在系统SDK 当中的，所以需要把完整的包路径写出来。

准备一个适配器

接下来为RecyclerView 准备一个适配器，在Activity 的java 文件中新建FruitAdapter 类，继承自RecyclerView.Adapter，并将泛型指定为FruitAdapter.ViewHolder。其中，ViewHolder 是我们在FruitAdapter 中定义的一个内部类：

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

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

        public ViewHolder(View view){
            super(view);
            fruitImage = view.findViewById(R.id.fruit_image);
            fruitName = view.findViewById(R.id.fruit_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.fruitImage.setImageResource(fruit.getImageId());
        holder.fruitName.setText(fruit.getName());
    }

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

这段代码中，我们首先定义了一个内部类ViewHolder，ViewHolder 要继承自RecyclerView.ViewHolder。然后ViewHolder 的构造函数中要传入一个View 参数，这个参数通常就是RecyclerView 子项的最外层布局，然后就可以通过findViewById() 方法来获取到布局中的ImageView 和TextView 的实例了。

在下面，FruitAdapter 也有一个构造函数，这个方法将要展示的数据源传进来，并赋值给一个全局变量mFruitList，后续操作都将在这个数据源的基础上进行

由于FruitAdapter 继承自RecyclerView.Adapter，所以必须重写onCreateViewHolder()、onBindViewHolder()、getItemCount() 方法。

1. onCreateViewHolder() 方法用于创建ViewHolder 实例，在这个方法中将fruit_item 布局加载进来，然后创建一个ViewHolder 实例，并把加载出来的布局传入到构造函数当中，最后将ViewHolder 的实例返回；
2. onBindViewHolder() 方法用于对RecyclerView 子项的数据进行赋值，在每个子项被滚动到屏幕内的时候执行，这里我们通过position 参数得到当前项的Fruit 实例，然后再将数据设置到ViewHolder 的ImageView 和TextView 当中即可；
3. getItemCount() 方法用于告诉RecyclerView 一共有多少子项，直接返回数据源的长度就可以了。

使用RecyclerView

回到Activity 的java 文件

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_recycle_view);
    initFruits();
    RecyclerView recyclerView = findViewById(R.id.recycler_view);
    LinearLayoutManager layoutManager = new LinearLayoutManager(this);
    recyclerView.setLayoutManager(layoutManager);
    FruitAdapter adapter = new FruitAdapter(fruitList);
    recyclerView.setAdapter(adapter);
}

/* 添加Item 数据（初始化） */
private void initFruits(){
    for(int i=0; i<2; i++){
        Fruit a1 = new Fruit("AndroidEatApple", R.drawable.android_eat_apple);
        fruitList.add(a1);
        Fruit a2 = new Fruit("Boy", R.drawable.user);
        fruitList.add(a2);
        ... ...
    }
}

可以看到，我们先在onCreate() 方法中获取到RecyclerView 的实例，然后创建一个LinearLayoutManager 对象，并将其设置到RecyclerView 当中。LayoutManager 用于指定RecyclerView 的布局方式，这里使用的LinearLayoutManager 是线性布局的意思，可以实现和ListView 类似的效果。接下来创建了FruitAdapter 的实例，并将水果数据传入到FruitAdapter 的构造函数中，最后调用RecyclerView 的setAdapter() 方法来完成适配器设置，这样RecyclerView 和数据之间的关联就建立完成了。