在Java项目开发中，XML文档常被用来存储配置信息或数据交换内容，Dom4j作为一款灵活的XML解析框架，提供了便捷的API来操作XML文档，其中修改XML文档是开发中非常常见的需求，要完成这个操作首先需要正确引入Dom4j的相关依赖。
一、引入Dom4j依赖
1. Maven项目引入方式
如果项目是基于Maven构建的，只需要在项目的pom.xml文件中添加Dom4j的依赖坐标即可，目前常用的稳定版本是2.1.3，添加后Maven会自动下载对应的jar包到本地仓库。
<dependency>
<groupId>org.dom4j</groupId>
<artifactId>dom4j</artifactId>
<version>2.1.3</version>
</dependency>2. 普通Java项目引入方式
如果是没有使用构建工具的普通Java项目，需要先从官方渠道下载Dom4j的jar包，然后将jar包添加到项目的类路径中。如果是IDEA开发工具，可以右键点击项目中的jar包，选择Add to Build Path完成依赖引入。
二、使用Dom4j修改XML文档的完整流程
修改XML文档的核心步骤包括读取原XML文档、获取需要操作的节点、执行修改操作、将修改后的内容写回文件，下面通过一个具体的示例来演示整个过程。
1. 待修改的XML示例文档
假设我们有一个名为user.xml的文档，内容如下：
<?xml version="1.0" encoding="UTF-8"?>
<users>
<user id="1">
<name>张三</name>
<age>20</age>
<email>zhangsan@ipipp.com</email>
</user>
<user id="2">
<name>李四</name>
<age>22</age>
<email>lisi@ipipp.com</email>
</user>
</users>2. 读取XML文档
首先需要使用Dom4j的SAXReader类读取XML文档，得到Document对象，后续的所有修改操作都基于这个对象进行。
import org.dom4j.Document;
import org.dom4j.DocumentException;
import org.dom4j.io.SAXReader;
import java.io.File;
public class Dom4jModifyDemo {
public static void main(String[] args) {
// 创建SAXReader实例
SAXReader reader = new SAXReader();
try {
// 读取XML文档，得到Document对象
Document document = reader.read(new File("user.xml"));
// 后续修改操作会在这里补充
} catch (DocumentException e) {
e.printStackTrace();
}
}
}3. 修改已有节点内容
比如我们需要将id为1的用户年龄修改为25，可以通过XPath表达式定位到对应的节点，然后修改其文本内容。
import org.dom4j.Document;
import org.dom4j.DocumentException;
import org.dom4j.Node;
import org.dom4j.io.SAXReader;
import java.io.File;
public class Dom4jModifyDemo {
public static void main(String[] args) {
SAXReader reader = new SAXReader();
try {
Document document = reader.read(new File("user.xml"));
// 使用XPath定位id为1的用户的age节点
Node ageNode = document.selectSingleNode("/users/user[@id='1']/age");
if (ageNode != null) {
// 修改节点文本内容
ageNode.setText("25");
System.out.println("修改年龄成功");
}
} catch (DocumentException e) {
e.printStackTrace();
}
}
}4. 添加新节点
我们可以在id为2的用户节点下添加一个新的phone子节点，存储用户的电话号码。
import org.dom4j.Document;
import org.dom4j.DocumentException;
import org.dom4j.Element;
import org.dom4j.Node;
import org.dom4j.io.SAXReader;
import java.io.File;
public class Dom4jModifyDemo {
public static void main(String[] args) {
SAXReader reader = new SAXReader();
try {
Document document = reader.read(new File("user.xml"));
// 定位id为2的user节点
Node userNode = document.selectSingleNode("/users/user[@id='2']");
if (userNode != null) {
Element userElement = (Element) userNode;
// 添加phone子节点
Element phoneElement = userElement.addElement("phone");
phoneElement.setText("13800138000");
System.out.println("添加手机号节点成功");
}
} catch (DocumentException e) {
e.printStackTrace();
}
}
}5. 删除指定节点
如果需要删除id为1的用户下的email节点，可以先定位到该节点，然后通过其父节点执行删除操作。
import org.dom4j.Document;
import org.dom4j.DocumentException;
import org.dom4j.Element;
import org.dom4j.Node;
import org.dom4j.io.SAXReader;
import java.io.File;
public class Dom4jModifyDemo {
public static void main(String[] args) {
SAXReader reader = new SAXReader();
try {
Document document = reader.read(new File("user.xml"));
// 定位id为1的用户的email节点
Node emailNode = document.selectSingleNode("/users/user[@id='1']/email");
if (emailNode != null) {
Element emailElement = (Element) emailNode;
// 获取父节点，执行删除操作
Element parentElement = emailElement.getParent();
parentElement.remove(emailElement);
System.out.println("删除邮箱节点成功");
}
} catch (DocumentException e) {
e.printStackTrace();
}
}
}6. 保存修改后的文档
所有的修改操作都是在内存中的Document对象上进行的，最后需要使用XMLWriter将修改后的内容写回原文件或者新文件。
import org.dom4j.Document;
import org.dom4j.DocumentException;
import org.dom4j.Element;
import org.dom4j.Node;
import org.dom4j.io.OutputFormat;
import org.dom4j.io.SAXReader;
import org.dom4j.io.XMLWriter;
import java.io.File;
import java.io.FileOutputStream;
public class Dom4jModifyDemo {
public static void main(String[] args) {
SAXReader reader = new SAXReader();
try {
Document document = reader.read(new File("user.xml"));
// 修改id为1的用户年龄
Node ageNode = document.selectSingleNode("/users/user[@id='1']/age");
if (ageNode != null) {
ageNode.setText("25");
}
// 给id为2的用户添加手机号节点
Node userNode = document.selectSingleNode("/users/user[@id='2']");
if (userNode != null) {
Element userElement = (Element) userNode;
Element phoneElement = userElement.addElement("phone");
phoneElement.setText("13800138000");
}
// 删除id为1的用户的邮箱节点
Node emailNode = document.selectSingleNode("/users/user[@id='1']/email");
if (emailNode != null) {
Element emailElement = (Element) emailNode;
Element parentElement = emailElement.getParent();
parentElement.remove(emailElement);
}
// 设置输出格式，避免中文乱码，同时格式化输出
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();
}
}
}三、注意事项
- 使用XPath定位节点时，需要确保Dom4j的依赖中包含了XPath的支持，高版本Dom4j已经内置了相关功能，低版本可能需要额外引入jaxen依赖。
- 写回文件时建议指定编码格式，和原XML文档的编码保持一致，避免出现中文乱码问题。
- 修改节点属性时，可以使用
element.attribute("属性名").setValue("新属性值")的方式完成操作。 - 操作文件时需要注意文件路径的正确性，相对路径是相对于项目的工作目录，也可以使用绝对路径避免路径错误。
通过以上的步骤，就可以完整实现使用Dom4j修改XML文档的所有操作，开发者可以根据实际的需求调整对应的节点操作逻辑，快速完成XML文档的修改工作。