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

DOM4J 是 Java 中一个功能强大且易用的开源 XML 处理库,支持读取、修改、生成和写入 XML 文档。它结合了 DOM 的易用性与 SAX 的低内存占用优势,是处理中小型 XML 文件的首选之一。
添加 DOM4J 依赖
使用 Maven 项目时,在 pom.xml 中添加以下依赖(推荐使用最新稳定版,如 2.1.4):
- 若使用 Maven:
注意:DOM4J 2.x 版本已内置 JAXEN 支持,无需额外引入 XPath 相关依赖。
使用 DOM4J 读取 XML 文件
通过 SAXReader 加载 XML,得到 Document 对象后可遍历或查询节点。
立即学习“Java免费学习笔记(深入)”;
- 基本读取示例:
Document document = reader.read(new File("config.xml"));
Element root = document.getRootElement();
System.out.println("根元素:" + root.getName());
- 读取时可设置是否验证 DTD 或 XSD:
reader.setIgnoreComments(true);
常见异常包括 DocumentException,建议用 try-catch 包裹读取逻辑。
使用 DOM4J 查询和修改 XML 内容
DOM4J 支持 XPath 表达式快速定位节点,也支持链式调用遍历子元素。
- 用 XPath 查找所有 name 元素:
for (Element e : names) {
System.out.println(e.getTextTrim());
}
- 修改某个属性或文本内容:
if (user != null) {
user.addAttribute("status", "active");
user.element("age").setText("28");
}
使用 DOM4J 写入 XML 文件
修改完成后,用 XMLWriter 或 OutputFormat 控制格式化输出。
- 带缩进和编码的写入方式:
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 处理需求。










