DOM4J 是 Java 中功能强大且易用的开源 XML 处理库，支持读取、修改、生成和写入 XML 文档，结合 DOM 易用性与 SAX 低内存优势，适用于中小型 XML 文件处理。

DOM4J 是 Java 中一个功能强大且易用的开源 XML 处理库，支持读取、修改、生成和写入 XML 文档。它结合了 DOM 的易用性与 SAX 的低内存占用优势，是处理中小型 XML 文件的首选之一。

添加 DOM4J 依赖

使用 Maven 项目时，在 pom.xml 中添加以下依赖（推荐使用最新稳定版，如 2.1.4）：

• 若使用 Maven：

  org.dom4j
  dom4j
  2.1.4

注意：DOM4J 2.x 版本已内置 JAXEN 支持，无需额外引入 XPath 相关依赖。

使用 DOM4J 读取 XML 文件

通过 SAXReader 加载 XML，得到 Document 对象后可遍历或查询节点。

立即学习“Java免费学习笔记（深入）”；

Java Api Extractor

从 Java 项目中提取 Controller 层接口定义为 JSON 数据。

下载

• 基本读取示例：

SAXReader reader = new SAXReader();
Document document = reader.read(new File("config.xml"));
Element root = document.getRootElement();
System.out.println("根元素：" + root.getName());

• 读取时可设置是否验证 DTD 或 XSD：

reader.setValidation(false);
reader.setIgnoreComments(true);

常见异常包括 DocumentException，建议用 try-catch 包裹读取逻辑。

使用 DOM4J 查询和修改 XML 内容

DOM4J 支持 XPath 表达式快速定位节点，也支持链式调用遍历子元素。

• 用 XPath 查找所有 name 元素：

List names = root.selectNodes("//name");
for (Element e : names) {
  System.out.println(e.getTextTrim());
}

• 修改某个属性或文本内容：

Element user = root.element("user");
if (user != null) {
  user.addAttribute("status", "active");
  user.element("age").setText("28");
}

使用 DOM4J 写入 XML 文件

修改完成后，用 XMLWriter 或 OutputFormat 控制格式化输出。

• 带缩进和编码的写入方式：

OutputFormat format = OutputFormat.createPrettyPrint();
format.setEncoding("UTF-8");
XMLWriter writer = new XMLWriter(new FileWriter("output.xml"), format);
writer.write(document);
writer.close();

• 若只需紧凑格式（无换行缩进），用 OutputFormat.createCompactFormat()
• 写入时注意关闭流，避免资源泄漏；也可用 try-with-resources 管理（需包装为 AutoCloseable）

DOM4J 上手快、API 清晰，适合配置文件解析、数据交换等常见场景。掌握读取、XPath 查询、属性/文本修改和格式化写入这四个环节，就能覆盖大部分 XML 处理需求。