安卓基础(适配器和RecyclerView )
RecyclerView
// 🍎 第一步:准备水果数据(假装这是你的数据)
List<String> fruitList = new ArrayList<>();
fruitList.add("苹果");
fruitList.add("香蕉");
fruitList.add("橘子"); // ...继续添加其他水果// 🚚 第二步:创建 RecyclerView 的 Adapter(卡车司机)
public class FruitAdapter extends RecyclerView.Adapter<FruitAdapter.FruitHolder> {private List<String> fruits;// 构造函数:传入水果数据public FruitAdapter(List<String> fruits) {this.fruits = fruits;}// 🛠️ 工作1:创建装水果的盒子(ViewHolder)@NonNull@Overridepublic FruitHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {// 用布局文件 item_fruit.xml 生成一个盒子View view = LayoutInflater.from(parent.getContext()).inflate(R.layout.item_fruit, parent, false);return new FruitHolder(view);}// 🎁 工作2:把水果放进盒子@Overridepublic void onBindViewHolder(@NonNull FruitHolder holder, int position) {String fruit = fruits.get(position);holder.fruitName.setText(fruit); // 设置水果名字}// 📊 工作3:告诉卡车有多少水果要运@Overridepublic int getItemCount() {return fruits.size();}// 📦 盒子的设计(静态内部类,避免内存泄漏)public static class FruitHolder extends RecyclerView.ViewHolder {TextView fruitName;public FruitHolder(@NonNull View itemView) {super(itemView);fruitName = itemView.findViewById(R.id.tv_fruit_name); // 找到盒子里的文字区域}}
}// 🌟 第三步:在 Activity 中绑定 RecyclerView
RecyclerView recyclerView = findViewById(R.id.recyclerView);
recyclerView.setLayoutManager(new LinearLayoutManager(this)); // 设置排列方式(竖着排)
FruitAdapter adapter = new FruitAdapter(fruitList);
recyclerView.setAdapter(adapter);
🧩 配套的布局文件(item_fruit.xml
)
<!-- 每个水果盒子的样式 -->
<TextViewxmlns:android="http://schemas.android.com/apk/res/android"android:id="@+id/tv_fruit_name"android:layout_width="match_parent"android:layout_height="wrap_content"android:padding="20dp"android:textSize="18sp"/>
🌈 代码比喻
-
FruitAdapter
:就像快递公司的 “装箱机器人”,负责把水果装进标准盒子里。 -
onCreateViewHolder
:机器人第一次看到盒子时,从模板(item_fruit.xml)造新盒子。 -
onBindViewHolder
:机器人把具体的水果(数据)塞进盒子里。 -
FruitHolder
:盒子的设计图纸,规定每个盒子长什么样。
下次滑动列表时,记得对手机说:“机器人又在回收盒子啦!” 😆
- Adapter 是乐高大师:把乱糟糟的积木变成漂亮的小火车!
- RecyclerView 是轨道:只放得下 5 节车厢,但 Adapter 会偷偷回收滑出屏幕的车厢,改装成新车厢~
🚚 Adapter 代码(Java版)
// 🍎 快递员:水果搬运工(Adapter)
public class FruitAdapter extends RecyclerView.Adapter<FruitAdapter.FruitHolder> {// 三个重要东西:private Context context; // 📍 位置(在哪显示)private List<String> fruits; // 🍇 水果清单(数据)private ItemClickListener listener; // 🖐️ 小手(点击监听)// 快递员的工具包(构造函数)public FruitAdapter(Context context, List<String> fruits, ItemClickListener listener) {this.context = context;this.fruits = fruits;this.listener = listener;}// 🌟 超能力1:造车厢!(用模板拼装)@Overridepublic FruitHolder onCreateViewHolder(ViewGroup parent, int viewType) {// 用图纸 item_fruit.xml 造车厢View view = LayoutInflater.from(context).inflate(R.layout.item_fruit, parent, false);return new FruitHolder(view); // 返回一个装好的车厢}// 🌟 超能力2:贴水果标签!(绑定数据)@Overridepublic void onBindViewHolder(FruitHolder holder, int position) {String fruit = fruits.get(position); // 拿到第几个水果holder.tvFruit.setText(fruit); // 贴在车厢上// 点击车厢时,告诉"小手"(监听器)holder.itemView.setOnClickListener(v -> {if (listener != null) {listener.onItemClick(position);}});}// 🌟 超能力3:数水果!(告诉火车有多少节)@Overridepublic int getItemCount() {return fruits.size();}// 🚂 车厢设计图(ViewHolder)public static class FruitHolder extends RecyclerView.ViewHolder {TextView tvFruit; // 车厢里的文字标签public FruitHolder(View itemView) {super(itemView);tvFruit = itemView.findViewById(R.id.tv_fruit); // 找到标签的位置}}// 🖐️ 小手接口(处理点击)public interface ItemClickListener {void onItemClick(int position);}
}
📦 配套的 XML 布局(item_fruit.xml)
<!-- 每个小车厢的样式 -->
<LinearLayoutxmlns:android="http://schemas.android.com/apk/res/android"android:layout_width="match_parent"android:layout_height="wrap_content"android:orientation="vertical"android:padding="16dp"><!-- 显示水果名字的标签 --><TextViewandroid:id="@+id/tv_fruit"android:layout_width="wrap_content"android:layout_height="wrap_content"android:textSize="20sp"android:textColor="#000000"/></LinearLayout>
🌟 getItemCount()
的作用
就是快递员对着包裹山大喊:“老板!今天要送多少件货啊?”
然后老板回答:“有 3 个水果包裹,5 本书包裹,总共 8 件!”
在代码中,这个方法告诉 RecyclerView 需要显示多少项数据!
public class SimpleAdapter extends RecyclerView.Adapter<...> {private List<String> dataList; // 数据源(比如水果列表)@Overridepublic int getItemCount() {// 返回数据总数,比如 dataList 有 10 个水果,就显示 10 项return dataList.size(); }
}
💥 如果忘记写这个方法(或者返回 0)
RecyclerView 会懵圈:“到底要显示多少项?0 项?那我不显示了!”
结果就是 空白页面,什么也看不到!
🌈 一句话总结
getItemCount()
= 告诉 RecyclerView 数据有多少条,一条数据对应一个列表项!
// 🐯 动物园动物信息适配器(处理两种类型:食肉动物、食草动物)
public class ZooAdapter extends RecyclerView.Adapter<ZooAdapter.AnimalHolder> {// 点击监听接口public interface OnAnimalClickListener {void onAnimalClick(int position); // 点击动物项}// 数据private List<Object> animals; // 混合类型数据(Lion/Tiger 或 Deer)private OnAnimalClickListener listener;public ZooAdapter(List<Object> animals, OnAnimalClickListener listener) {this.animals = animals;this.listener = listener;}// 🦁 类型判断@Overridepublic int getItemViewType(int position) {Object animal = animals.get(position);if (animal instanceof Lion || animal instanceof Tiger) {return 0; // 类型0:食肉动物} else {return 1; // 类型1:食草动物}}// 🛠️ 创建视图(两种不同布局)@NonNull@Overridepublic AnimalHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {LayoutInflater inflater = LayoutInflater.from(parent.getContext());View view;if (viewType == 0) {view = inflater.inflate(R.layout.item_carnivore, parent, false); // 食肉动物布局} else {view = inflater.inflate(R.layout.item_herbivore, parent, false); // 食草动物布局}return new AnimalHolder(view);}// 🎨 绑定数据@Overridepublic void onBindViewHolder(@NonNull AnimalHolder holder, int position) {Object animal = animals.get(position);if (animal instanceof Lion) {Lion lion = (Lion) animal;holder.bindCarnivore(lion.getName(), "🦁 食肉动物");} else if (animal instanceof Tiger) {Tiger tiger = (Tiger) animal;holder.bindCarnivore(tiger.getName(), "🐯 食肉动物");} else if (animal instanceof Deer) {Deer deer = (Deer) animal;holder.bindHerbivore(deer.getName(), "🌿 每天吃草");}// 点击事件holder.itemView.setOnClickListener(v -> {if (listener != null) {listener.onAnimalClick(position);}});}// 📊 数据总数@Overridepublic int getItemCount() {return animals.size();}// 🐾 视图承载器static class AnimalHolder extends RecyclerView.ViewHolder {TextView tvName;TextView tvType;ImageView ivIcon;public AnimalHolder(@NonNull View itemView) {super(itemView);tvName = itemView.findViewById(R.id.tvName);tvType = itemView.findViewById(R.id.tvType);ivIcon = itemView.findViewById(R.id.ivIcon);}// 绑定食肉动物数据void bindCarnivore(String name, String type) {tvName.setText(name);tvType.setText(type);ivIcon.setImageResource(R.drawable.ic_lion); // 狮子图标}// 绑定食草动物数据void bindHerbivore(String name, String diet) {tvName.setText(name);tvType.setText(diet);ivIcon.setImageResource(R.drawable.ic_deer); // 鹿图标}}
}
🧩 对应数据结构模型
// 🦁 食肉动物基类
abstract class Carnivore {abstract String getName();
}class Lion extends Carnivore {@Override String getName() { return "辛巴 Lion"; }
}class Tiger extends Carnivore {@Override String getName() { return "理查德 Tiger"; }
}// 🦌 食草动物
class Deer {String getName() { return "斑比 Deer"; }
}
📦 布局文件示例(item_carnivore.xml)
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"android:layout_width="match_parent"android:layout_height="80dp"android:background="#FFF0F0"android:orientation="horizontal"><ImageViewandroid:id="@+id/ivIcon"android:layout_width="60dp"android:layout_height="60dp"android:src="@drawable/ic_lion"/><LinearLayout android:layout_width="match_parent"android:layout_height="match_parent"android:orientation="vertical"android:padding="8dp"><TextViewandroid:id="@+id/tvName"android:layout_width="wrap_content"android:layout_height="wrap_content"android:textSize="18sp"android:textColor="#FF0000"/><TextViewandroid:id="@+id/tvType"android:layout_width="wrap_content"android:layout_height="wrap_content"android:textSize="14sp"/></LinearLayout>
</LinearLayout>
🎮 使用示例
List<Object> animals = new ArrayList<>();
animals.add(new Lion());
animals.add(new Deer());
animals.add(new Tiger());ZooAdapter adapter = new ZooAdapter(animals, position -> {Toast.makeText(this, "点击了:" + position, Toast.LENGTH_SHORT).show();
});recyclerView.setAdapter(adapter);
recyclerView.setLayoutManager(new LinearLayoutManager(this));
通过这个动物园例子,可以清晰看到适配器的核心逻辑:
1️⃣ 分类数据 → 判断是狮子还是鹿
2️⃣ 选择模板 → 用不同布局文件
3️⃣ 填充内容 → 设置名字和图标
4️⃣ 处理交互 → 点击反馈
就像动物园管理员根据动物种类,选择不同的展示牌和饲养方式 🦁→🌿
RecyclerView.ViewHolder
-
问题背景:
在列表滚动时,若每次绑定数据都通过findViewById
查找子视图(如TextView
、Button
),会频繁触发资源查找和对象创建,导致性能下降(卡顿)。 -
ViewHolder 的解决方案:
将列表项的子视图(如TextView
)缓存在ViewHolder
中。
这样在滚动时,只需在 首次创建列表项 时调用findViewById
,后续滚动时直接复用缓存的视图组件,避免重复查找。
-
RecyclerView 的复用机制:
当列表项滚出屏幕时,其对应的ViewHolder
会被放入 回收池(Recycler Pool)。当新列表项需要显示时,优先从回收池中获取旧的ViewHolder
并绑定新数据(无需重新创建视图)。 -
关键方法:
onCreateViewHolder()
:仅当没有可复用的ViewHolder
时调用,用于首次创建。onBindViewHolder()
:每次数据绑定时调用,复用已有的ViewHolder
。
方法 | onCreateViewHolder | onBindViewHolder |
---|---|---|
核心职责 | 创建列表项的视图和 ViewHolder | 将数据绑定到视图 |
调用频率 | 低(仅在需要新视图时调用) | 高(每次数据变化或滚动时都可能调用) |
性能优化点 | 减少视图创建次数(通过复用 ViewHolder ) | 减少 findViewById 调用(通过 ViewHolder 缓存视图) |
典型操作 | 初始化布局文件,创建 ViewHolder | 设置文本、图片、点击事件等 |
是否强制实现 | 是 | 是 |
RecyclerView.Adapter
是 连接数据与 RecyclerView
列表的桥梁,它的核心作用是 管理列表项的显示逻辑和数据绑定。
通过 Adapter
通知 RecyclerView
刷新界面。
问题 | 原因 | 解决方案 |
---|---|---|
列表显示空白 | getItemCount() 返回 0 或数据未正确传递 | 检查数据源是否为空,确保正确赋值给 Adapter 。 |
滚动卡顿 | onBindViewHolder 中有耗时操作 | 避免在数据绑定时执行复杂逻辑(如网络请求)。 |
视图状态错乱(复用问题) | 未在 onBindViewHolder 中重置视图状态 | 确保每次绑定数据时更新所有相关视图属性。 |