本文介绍如何重构一个遍历多级 xml 文件并校验跨文件 id 引用完整性的 java 程序，重点解决函数间过度传递参数、错误上下文缺失（如目录路径）、重复日志等问题，通过职责分离、不可变数据流和集中式错误管理提升代码可维护性与健壮性。
本文介绍如何重构一个遍历多级 xml 文件并校验跨文件 id 引用完整性的 java 程序，重点解决函数间过度传递参数、错误上下文缺失（如目录路径）、重复日志等问题，通过职责分离、不可变数据流和集中式错误管理提升代码可维护性与健壮性。
在处理嵌套目录下的 XML 资源引用校验任务时，原始代码存在典型的“参数瀑布”（parameter waterfall）问题：readDirectory → readXML → readContents → checkAttributes 层层透传 List，同时丢失关键上下文（如当前文件所在子目录名），且无法对同一缺失 ID（如 id9）去重告警。这不仅降低可读性，更阻碍扩展——例如后续需支持 JSON 混合格式或输出结构化报告时，修改成本极高。
✅ 重构核心原则
-
单一职责 & 明确输入/输出：每个方法只做一件事，并返回明确结果（如
List、Document、Set）； -
上下文自包含：将路径、目录名等元信息随数据流转（如封装为
XmlResource类），而非依赖外部参数； -
错误聚合与去重：使用
Set统一收集、自动去重，并在最后统一输出，支持灵活扩展（如写入日志文件、发送告警）； - 异常防御性处理：XML 解析失败不中断整体流程，仅记录警告并跳过该文件。
? 重构后关键代码示例
existingIds
