如何使用DOM4J进行XML编程

XML编程是Java开发中常见的需求，DOM4J作为轻量且功能强大的XML处理库，支持DOM、SAX等多种解析方式，能够高效完成XML文档的读取、创建、修改和查询等操作，是很多Java项目处理XML的首选工具。

环境准备

使用DOM4J前需要先导入对应的依赖，如果是Maven项目，可以在pom.xml中添加如下依赖：

<dependency>
    <groupId>org.dom4j</groupId>
    <artifactId>dom4j</artifactId>
    <version>2.1.4</version>
</dependency>

如果是普通Java项目，可以下载DOM4J的jar包，手动导入到项目的类路径中即可。

DOM4J解析XML文档

解析XML是DOM4J最常用的功能之一，下面以解析一个存储用户信息的XML文件为例，演示解析的完整流程。

待解析的user.xml内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<users>
    <user id="1">
        <name>张三</name>
        <age>25</age>
        <email>zhangsan@ipipp.com</email>
    </user>
    <user id="2">
        <name>李四</name>
        <age>28</age>
        <email>lisi@ipipp.com</email>
    </user>
</users>

解析该XML的Java代码如下：

import org.dom4j.Document;
import org.dom4j.DocumentException;
import org.dom4j.Element;
import org.dom4j.io.SAXReader;
import java.io.File;
import java.util.List;

public class Dom4jParseDemo {
    public static void main(String[] args) {
        // 创建SAXReader对象
        SAXReader reader = new SAXReader();
        try {
            // 读取XML文件，生成Document对象
            Document document = reader.read(new File("user.xml"));
            // 获取根元素
            Element rootElement = document.getRootElement();
            System.out.println("根元素名称：" + rootElement.getName());
            // 获取所有user子元素
            List<Element> userElements = rootElement.elements("user");
            for (Element userElement : userElements) {
                // 获取user元素的id属性
                String id = userElement.attributeValue("id");
                // 获取name子元素的内容
                String name = userElement.elementText("name");
                // 获取age子元素的内容
                String age = userElement.elementText("age");
                // 获取email子元素的内容
                String email = userElement.elementText("email");
                System.out.println("用户ID：" + id + "，姓名：" + name + "，年龄：" + age + "，邮箱：" + email);
            }
        } catch (DocumentException e) {
            e.printStackTrace();
        }
    }
}

使用DOM4J生成XML文档

除了解析XML，DOM4J也支持快速生成XML文档，下面演示生成一个简单的配置XML文件的流程。

import org.dom4j.Document;
import org.dom4j.DocumentHelper;
import org.dom4j.Element;
import org.dom4j.io.OutputFormat;
import org.dom4j.io.XMLWriter;
import java.io.FileOutputStream;

public class Dom4jCreateDemo {
    public static void main(String[] args) {
        try {
            // 创建Document对象
            Document document = DocumentHelper.createDocument();
            // 创建根元素config
            Element rootElement = document.addElement("config");
            // 添加子元素db
            Element dbElement = rootElement.addElement("db");
            // 添加db的子元素
            dbElement.addElement("driver").setText("com.mysql.jdbc.Driver");
            dbElement.addElement("url").setText("jdbc:mysql://127.0.0.1:3306/test");
            dbElement.addElement("username").setText("root");
            dbElement.addElement("password").setText("123456");
            // 设置输出格式，缩进排版
            OutputFormat format = OutputFormat.createPrettyPrint();
            format.setEncoding("UTF-8");
            // 输出到文件
            XMLWriter writer = new XMLWriter(new FileOutputStream("config.xml"), format);
            writer.write(document);
            writer.close();
            System.out.println("XML生成成功");
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

DOM4J修改XML文档

DOM4J还可以对已有的XML文档进行修改，比如修改元素内容、添加新元素、删除元素等，下面是修改上述user.xml中第一个用户年龄的示例：

import org.dom4j.Document;
import org.dom4j.DocumentException;
import org.dom4j.Element;
import org.dom4j.io.SAXReader;
import org.dom4j.io.XMLWriter;
import org.dom4j.io.OutputFormat;
import java.io.File;
import java.io.FileOutputStream;
import java.util.List;

public class Dom4jModifyDemo {
    public static void main(String[] args) {
        SAXReader reader = new SAXReader();
        try {
            Document document = reader.read(new File("user.xml"));
            Element rootElement = document.getRootElement();
            List<Element> userElements = rootElement.elements("user");
            if (!userElements.isEmpty()) {
                // 修改第一个用户的age元素内容
                Element firstUser = userElements.get(0);
                Element ageElement = firstUser.element("age");
                ageElement.setText("26");
                // 给第一个用户添加新元素phone
                firstUser.addElement("phone").setText("13800138000");
            }
            // 保存修改后的文档
            OutputFormat format = OutputFormat.createPrettyPrint();
            format.setEncoding("UTF-8");
            XMLWriter writer = new XMLWriter(new FileOutputStream("user.xml"), format);
            writer.write(document);
            writer.close();
            System.out.println("XML修改成功");
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

DOM4J常用操作总结

DOM4J的核心操作主要围绕Document、Element、Attribute这几个核心类展开，常用方法整理如下：

掌握这些基础方法后，就可以应对大部分XML编程场景的需求，在实际使用中可以根据具体场景灵活组合这些方法完成更复杂的XML处理操作。

DOM4JXML解析Java_XMLXML生成XML操作修改时间：2026-06-04 03:44:39