Java DOM4J库使用教程 DOM4J读取和写入XML

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 对象后可遍历或查询节点。

  • 基本读取示例:
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 文件

修改完成后,用 XMLWriterOutputFormat 控制格式化输出。

  • 带缩进和编码的写入方式:
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 处理需求。