CommonAdapter数据自动刷新揭秘:ObservableList如何让数据变更后界面自动更新
CommonAdapter数据自动刷新揭秘:ObservableList如何让数据变更后界面自动更新
CommonAdapter 是一款通过封装 BaseAdapter 与 RecyclerView.Adapter 得到的通用、简易 Android 适配器框架。它有一个常被忽略的隐藏能力:只要把 ObservableList 类型的数据传入 Adapter,数据增删改后界面就会自动刷新,无需手动调用 notifyDataSetChanged()。这篇文章带你揭秘 CommonAdapter 数据自动刷新背后的完整机制,并给出使用前提与常见误区。
为什么普通数据变更后界面不会刷新?
在传统 Android 开发中,列表刷新的链条是断的:List 只是纯数据容器,不知道谁在展示自己;Adapter 持有数据引用,但无法感知数据内部的增删;ListView/RecyclerView 只有在收到 Adapter 的 notify* 通知后才会重新布局。
所以常规做法是每次改完数据,手动补一句:
data.clear();
data.addAll(newData);
adapter.notifyDataSetChanged(); // 必须手动通知,否则界面不更新
一旦忘记调用,就会出现经典的"数据变了,界面没变"bug。CommonAdapter 数据自动刷新机制,正是为了打通这条断链而设计的。
自动刷新三部曲:判断注册、事件分发、精准通知
整个机制分布在三层,理解这三层就理解了一切。
第一步:判断环境,注册列表监听
当构造 Adapter 时,CommonAdapter 会先做两件事:
- 通过 DataBindingJudgement.java 反射检测项目中是否存在
android.databinding.ObservableList类,判断是否引入了 DataBinding 依赖; - 若支持,再检查传入的数据是否为
ObservableList实例,是则通过addOnListChangedCallback注册一个列表变化监听器。
核心逻辑见 CommonRcvAdapter.java:
if (DataBindingJudgement.SUPPORT_DATABINDING && data instanceof ObservableList) {
((ObservableList<T>) data).addOnListChangedCallback(new ObservableList.OnListChangedCallback<...>() {
// 各种回调 -> notifyXxx
});
}
这一步是"隐式"的:你什么代码都不用写,只要数据类型对了,监听就已就位。
第二步:数据一变,回调立刻触发
监听注册之后,数据的每次变动都需要有人"喊一嗓子"。演示模块提供了 ObservableArrayList.java,它继承 ArrayList 并实现 ObservableList 接口,在每一个会修改数据的操作(add、remove、set、clear、moveRange、reset)里追加一次监听者通知:
@Override
public boolean add(T object) {
super.add(object);
notifyAdd(size() - 1, 1); // 操作完成后立即通知所有监听者
return true;
}
也就是说,数据层自己承担了"报信"职责,业务代码只管正常操作数据。
第三步:把变化翻译成精准的 notify 通知
第三步最见功力。Adapter 注册的监听器把 5 种列表变化回调"翻译"成 RecyclerView 对应的细粒度通知(见 CommonRcvAdapter.java):
| ObservableList 回调 | 翻译成的 Adapter 通知 | 界面效果 |
|---|---|---|
onChanged |
notifyDataSetChanged |
整体重绘 |
onItemRangeChanged |
notifyItemRangeChanged |
仅刷新变化的区间 |
onItemRangeInserted |
notifyItemRangeInserted |
精准插入 |
onItemRangeRemoved |
notifyItemRangeRemoved |
精准删除 |
onItemRangeMoved |
局部区间刷新 | 移动后重排 |
细粒度通知比笼统的"全量刷新"更高效:只有真正变化的条目参与重绘,动画也更准确。对比之下,面向 ListView 的 CommonAdapter.java 由于 BaseAdapter 只提供了全量刷新接口,所有回调统一映射为 notifyDataSetChanged——机制相同,颗粒度不同。
实战演示:点击删除、数据重置,界面全自动更新
示例工程中的 HeaderFooterActivity.java 就是自动刷新的完整示范。它声明了一个 ObservableArrayList 作为数据源:
private ObservableArrayList<DemoModel> data = new ObservableArrayList<>();
后续所有交互都只操作数据,不再出现任何 notify 调用:
- 点击某一行:
data.remove(position)—— 该条目直接从界面消失; - 点击 Header:
data.add(0, model)—— 新条目自动插入列表顶部; - 延迟重置:
data.reset(newData)—— 整份数据替换,界面随之整体更新。
对比一下手动模式的做法(见 RecyclerViewActivity.java,每次都要手动 notifyDataSetChanged()),自动模式下数据与视图天然同步,彻底消除了"忘记通知"这类 bug。
使用 ObservableList 自动刷新的三个前提
想启用这个机制,需要同时满足三点:
- 项目引入 DataBinding 依赖,即 classpath 中能找到
android.databinding.ObservableList,否则 DataBindingJudgement 判定为不支持,监听根本不会注册; - 传入构造函数的数据必须是
ObservableList类型(如演示中的ObservableArrayList)。普通的ArrayList不会触发任何通知; - 监听只在 Adapter 构造时注册一次。如果之后用
setData()把数据源替换成一个普通 List,自动刷新能力随之失效——替换时请继续传ObservableList。
常见误区与注意事项
- 误区一:改了数据界面就该动。 前提不满足(比如数据是普通 ArrayList)时,机制完全不生效,务必用
ObservableArrayList声明数据源; - 误区二:
reset()是"无痕"替换。 它内部是 clear + addAll,触发的是onChanged整体重绘,而不是逐条 diff,大批量替换时属正常现象; - 移动数据请走
move()/moveRange(),而不是自己"删了再加",前者触发onItemRangeMoved,界面表现更自然; - 若需要更精细的增删动画与差异计算,可以参考示例中 DiffRcvActivity.java 里基于 DiffUtil 的写法,与自动刷新机制互补使用。
写在最后
CommonAdapter 数据自动刷新的本质,是把"通知责任"从业务代码前移到数据层:ObservableArrayList 负责报信,Adapter 内置的回调负责把变化翻译成细粒度 notify,两者在构造函数中自动挂钩。对开发者而言,收益是实实在在的——操作数据时再也不用惦记 notifyDataSetChanged(),数据变,界面就变。更多功能特性(多类型 item、头部尾部、空状态等)可以查阅 README.md 了解。
