《Android 应用开发基础教程》——第五章：RecyclerView 列表视图与适配器机制
目录
第五章：RecyclerView 列表视图与适配器机制
5.1 为什么要使用 RecyclerView？
5.2 基本结构图
5.3 RecyclerView 使用步骤
1️⃣ 添加 RecyclerView 依赖（Android Studio）
2️⃣ 布局文件（activity_main.xml）
3️⃣ 创建单项布局（item_text.xml）
4️⃣ 创建适配器类（MyAdapter.java）
5️⃣ 在 MainActivity 中使用 RecyclerView
5.4 支持点击事件
5.5 设置不同布局方式
网格布局：
瀑布流布局：
5.6 分割线和动画（可选）
添加分割线：
✅ 本章小结
习题答案
项目结构
1. MainActivity.java
2. DetailActivity.java
3. MyAdapter.java
4. ItemModel.java
5. activity_main.xml
6. activity_detail.xml
7. item_layout.xml
第五章：RecyclerView 列表视图与适配器机制
5.1 为什么要使用 RecyclerView？
RecyclerView 是 Android 中用于显示长列表或网格数据的强大控件，相比早期的 ListView 有以下优势：
| 优势 | 描述 |
|---|---|
| 灵活布局 | 支持线性、网格、瀑布流布局 |
| 高性能 | 内置“复用机制”，提高性能 |
| 自定义强 | 可自定义 ViewHolder、动画、分隔线 |
5.2 基本结构图
RecyclerView├── Adapter（适配器）│ └── ViewHolder（单项视图）└── LayoutManager（布局管理器）
5.3 RecyclerView 使用步骤
假设我们要展示一个简单的字符串列表。
1️⃣ 添加 RecyclerView 依赖（Android Studio）
dependencies {implementation 'androidx.recyclerview:recyclerview:1.3.1'
}
2️⃣ 布局文件（activity_main.xml）
<androidx.recyclerview.widget.RecyclerViewandroid:id="@+id/recyclerView"android:layout_width="match_parent"android:layout_height="match_parent"/>
3️⃣ 创建单项布局（item_text.xml）
<TextView xmlns:android="http://schemas.android.com/apk/res/android"android:id="@+id/textItem"android:layout_width="match_parent"android:layout_height="60dp"android:gravity="center_vertical"android:padding="16dp"android:textSize="18sp"/>
4️⃣ 创建适配器类（MyAdapter.java）
package com.example.myapp;import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.TextView;
import androidx.recyclerview.widget.RecyclerView;
import java.util.List;public class MyAdapter extends RecyclerView.Adapter<MyAdapter.MyViewHolder> {private List<String> dataList;public MyAdapter(List<String> dataList) {this.dataList = dataList;}// ViewHolder：缓存 item 控件static class MyViewHolder extends RecyclerView.ViewHolder {TextView textItem;MyViewHolder(View itemView) {super(itemView);textItem = itemView.findViewById(R.id.textItem);}}@Overridepublic MyViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {View view = LayoutInflater.from(parent.getContext()).inflate(R.layout.item_text, parent, false);return new MyViewHolder(view);}@Overridepublic void onBindViewHolder(MyViewHolder holder, int position) {holder.textItem.setText(dataList.get(position));}@Overridepublic int getItemCount() {return dataList.size();}
}
5️⃣ 在 MainActivity 中使用 RecyclerView
package com.example.myapp;import android.os.Bundle;
import androidx.appcompat.app.AppCompatActivity;
import androidx.recyclerview.widget.LinearLayoutManager;
import androidx.recyclerview.widget.RecyclerView;
import java.util.ArrayList;
import java.util.List;public class MainActivity extends AppCompatActivity {private RecyclerView recyclerView;private MyAdapter adapter;private List<String> stringList;@Overrideprotected void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);setContentView(R.layout.activity_main);recyclerView = findViewById(R.id.recyclerView);stringList = new ArrayList<>();// 添加测试数据for (int i = 1; i <= 20; i++) {stringList.add("第 " + i + " 项");}adapter = new MyAdapter(stringList);recyclerView.setLayoutManager(new LinearLayoutManager(this)); // 垂直列表recyclerView.setAdapter(adapter);}
}
5.4 支持点击事件
修改 MyAdapter.java 中的 onBindViewHolder 方法：
@Override
public void onBindViewHolder(MyViewHolder holder, int position) {holder.textItem.setText(dataList.get(position));holder.textItem.setOnClickListener(new View.OnClickListener() {@Overridepublic void onClick(View v) {Toast.makeText(v.getContext(), "点击了：" + dataList.get(position), Toast.LENGTH_SHORT).show();}});
}
5.5 设置不同布局方式
网格布局：
recyclerView.setLayoutManager(new GridLayoutManager(this, 2)); // 2 列
瀑布流布局：
recyclerView.setLayoutManager(new StaggeredGridLayoutManager(2, StaggeredGridLayoutManager.VERTICAL));
5.6 分割线和动画（可选）
添加分割线：
recyclerView.addItemDecoration(new DividerItemDecoration(this, DividerItemDecoration.VERTICAL));
✅ 本章小结
| 概念 | 说明 |
|---|---|
| RecyclerView | 高效列表展示控件 |
| Adapter | 数据适配器，负责绑定数据 |
| ViewHolder | 用于提高性能的视图缓存机制 |
| LayoutManager | 控制列表排列方式（线性、网格等） |
📌 练习题
-
修改 Adapter，点击列表项后跳转到新的 Activity 并传递字符串
-
使用 GridLayoutManager 显示 3 列网格
-
自定义 item 布局，包括头像、标题、内容三部分
✅ 下一章预告：
第六章：列表数据动态更新与刷新（如添加、删除、SwipeRefresh）
习题答案
项目结构
MainActivity.java
DetailActivity.java
MyAdapter.java
activity_main.xml
activity_detail.xml
item_layout.xml1. MainActivity.java
package com.example.demo;import android.content.Intent;
import android.os.Bundle;
import androidx.appcompat.app.AppCompatActivity;
import androidx.recyclerview.widget.GridLayoutManager;
import androidx.recyclerview.widget.RecyclerView;import java.util.ArrayList;
import java.util.List;public class MainActivity extends AppCompatActivity {private RecyclerView recyclerView;private MyAdapter adapter;private List<ItemModel> itemList;@Overrideprotected void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);setContentView(R.layout.activity_main);recyclerView = findViewById(R.id.recyclerView);// 初始化数据itemList = new ArrayList<>();itemList.add(new ItemModel("Avatar 1", "Title 1", "Content 1"));itemList.add(new ItemModel("Avatar 2", "Title 2", "Content 2"));itemList.add(new ItemModel("Avatar 3", "Title 3", "Content 3"));itemList.add(new ItemModel("Avatar 4", "Title 4", "Content 4"));itemList.add(new ItemModel("Avatar 5", "Title 5", "Content 5"));// 设置 Adapter 和 LayoutManageradapter = new MyAdapter(itemList, this);recyclerView.setLayoutManager(new GridLayoutManager(this, 3)); // 3 列网格布局recyclerView.setAdapter(adapter);// 设置点击事件监听器adapter.setOnItemClickListener(new MyAdapter.OnItemClickListener() {@Overridepublic void onItemClick(String title) {Intent intent = new Intent(MainActivity.this, DetailActivity.class);intent.putExtra("TITLE", title); // 传递标题startActivity(intent);}});}
}2. DetailActivity.java
package com.example.demo;import android.os.Bundle;
import android.widget.TextView;
import androidx.appcompat.app.AppCompatActivity;public class DetailActivity extends AppCompatActivity {private TextView textViewTitle;@Overrideprotected void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);setContentView(R.layout.activity_detail);textViewTitle = findViewById(R.id.textViewTitle);// 获取传递的标题并显示String title = getIntent().getStringExtra("TITLE");if (title != null) {textViewTitle.setText(title);}}
}3. MyAdapter.java
package com.example.demo;import android.content.Context;
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 MyAdapter extends RecyclerView.Adapter<MyAdapter.ViewHolder> {private List<ItemModel> itemList;private Context context;private OnItemClickListener listener;public MyAdapter(List<ItemModel> itemList, Context context) {this.itemList = itemList;this.context = context;}// 定义点击事件接口public interface OnItemClickListener {void onItemClick(String title);}public void setOnItemClickListener(OnItemClickListener listener) {this.listener = listener;}@NonNull@Overridepublic ViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {View view = LayoutInflater.from(context).inflate(R.layout.item_layout, parent, false);return new ViewHolder(view);}@Overridepublic void onBindViewHolder(@NonNull ViewHolder holder, int position) {ItemModel item = itemList.get(position);holder.textViewTitle.setText(item.getTitle());holder.textViewContent.setText(item.getContent());// 模拟头像（可以替换为实际图片加载逻辑）holder.imageViewAvatar.setImageResource(R.drawable.ic_launcher_foreground);// 设置点击事件holder.itemView.setOnClickListener(new View.OnClickListener() {@Overridepublic void onClick(View v) {if (listener != null) {listener.onItemClick(item.getTitle());}}});}@Overridepublic int getItemCount() {return itemList.size();}public static class ViewHolder extends RecyclerView.ViewHolder {ImageView imageViewAvatar;TextView textViewTitle;TextView textViewContent;public ViewHolder(@NonNull View itemView) {super(itemView);imageViewAvatar = itemView.findViewById(R.id.imageViewAvatar);textViewTitle = itemView.findViewById(R.id.textViewTitle);textViewContent = itemView.findViewById(R.id.textViewContent);}}
}4. ItemModel.java
package com.example.demo;public class ItemModel {private String avatar;private String title;private String content;public ItemModel(String avatar, String title, String content) {this.avatar = avatar;this.title = title;this.content = content;}public String getAvatar() {return avatar;}public String getTitle() {return title;}public String getContent() {return content;}
}5. activity_main.xml
<?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"android:orientation="vertical"><androidx.recyclerview.widget.RecyclerViewandroid:id="@+id/recyclerView"android:layout_width="match_parent"android:layout_height="match_parent"android:padding="8dp" />
</LinearLayout>6. activity_detail.xml
<?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"android:orientation="vertical"android:gravity="center"android:padding="16dp"><TextViewandroid:id="@+id/textViewTitle"android:layout_width="wrap_content"android:layout_height="wrap_content"android:text="Title"android:textSize="24sp" />
</LinearLayout>7. item_layout.xml
<?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="wrap_content"android:orientation="vertical"android:padding="8dp"android:gravity="center"><ImageViewandroid:id="@+id/imageViewAvatar"android:layout_width="64dp"android:layout_height="64dp"android:src="@drawable/ic_launcher_foreground"android:contentDescription="Avatar" /><TextViewandroid:id="@+id/textViewTitle"android:layout_width="wrap_content"android:layout_height="wrap_content"android:text="Title"android:textSize="16sp"android:gravity="center"android:paddingTop="4dp" /><TextViewandroid:id="@+id/textViewContent"android:layout_width="wrap_content"android:layout_height="wrap_content"android:text="Content"android:textSize="14sp"android:gravity="center"android:paddingTop="2dp" />
</LinearLayout>