Java JDOM2是一款专门为Java语言设计的XML解析与生成库，它充分贴合Java的集合框架特性，API设计简洁直观，相比DOM4J在部分场景下使用起来更加轻量便捷，适合处理各类XML格式的数据交互需求。
JDOM2与DOM4J的核心差异
JDOM2和DOM4J都属于基于树结构的XML处理库，但两者在设计理念上有明显区别：
- JDOM2完全基于Java集合框架设计，节点操作直接使用List等Java原生集合类型，无需额外适应自定义集合接口
- JDOM2的API命名更贴合Java开发者的使用习惯，方法调用逻辑更清晰，学习成本更低
- DOM4J支持更多的XML高级特性，比如更复杂的XPath查询、XML Schema校验等，适合处理复杂的XML场景
- JDOM2的依赖包体积更小，在轻量级项目中使用不会带来过多的依赖负担
JDOM2环境配置
如果使用Maven管理项目依赖，只需要在pom.xml中添加以下依赖即可引入JDOM2：
<dependency>
<groupId>org.jdom</groupId>
<artifactId>jdom2</artifactId>
<version>2.0.6</version>
</dependency>
如果是普通Java项目，可以下载JDOM2的jar包，导入到项目的类路径中即可使用。
使用JDOM2解析XML文件
下面通过一个示例演示如何读取本地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>
解析该文件的完整Java代码如下：
import org.jdom2.Document;
import org.jdom2.Element;
import org.jdom2.input.SAXBuilder;
import java.io.File;
import java.util.List;
public class JDOM2ParseDemo {
public static void main(String[] args) {
try {
// 创建SAX解析器构建器
SAXBuilder saxBuilder = new SAXBuilder();
// 读取XML文件构建Document对象
Document document = saxBuilder.build(new File("user.xml"));
// 获取根节点
Element rootElement = document.getRootElement();
// 获取所有user子节点
List<Element> userList = rootElement.getChildren("user");
// 遍历用户节点
for (Element user : userList) {
// 获取节点的id属性
String userId = user.getAttributeValue("id");
// 获取子节点内容
String name = user.getChildText("name");
String age = user.getChildText("age");
String email = user.getChildText("email");
System.out.println("用户ID：" + userId);
System.out.println("姓名：" + name);
System.out.println("年龄：" + age);
System.out.println("邮箱：" + email);
System.out.println("-------------------");
}
} catch (Exception e) {
e.printStackTrace();
}
}
}
使用JDOM2修改XML内容
JDOM2支持直接修改XML节点的内容和属性，修改完成后可以将更新后的内容写回文件。以下示例演示给第一个用户节点添加一个新的<phone>子节点：
import org.jdom2.Document;
import org.jdom2.Element;
import org.jdom2.input.SAXBuilder;
import org.jdom2.output.Format;
import org.jdom2.output.XMLOutputter;
import java.io.File;
import java.io.FileWriter;
import java.util.List;
public class JDOM2ModifyDemo {
public static void main(String[] args) {
try {
SAXBuilder saxBuilder = new SAXBuilder();
Document document = saxBuilder.build(new File("user.xml"));
Element rootElement = document.getRootElement();
List<Element> userList = rootElement.getChildren("user");
if (!userList.isEmpty()) {
// 获取第一个用户节点
Element firstUser = userList.get(0);
// 创建新的phone子节点
Element phoneElement = new Element("phone");
phoneElement.setText("13800138000");
// 添加子节点到用户节点
firstUser.addContent(phoneElement);
// 设置输出格式，缩进排版
Format format = Format.getPrettyFormat();
XMLOutputter xmlOutputter = new XMLOutputter(format);
// 将修改后的内容写回文件
xmlOutputter.output(document, new FileWriter("user.xml"));
System.out.println("XML文件修改完成");
}
} catch (Exception e) {
e.printStackTrace();
}
}
}
使用JDOM2生成新的XML文件
如果需要从零开始生成XML文件，JDOM2也提供了非常便捷的操作方式，以下代码演示生成一个简单的配置XML文件：
import org.jdom2.Document;
import org.jdom2.Element;
import org.jdom2.output.Format;
import org.jdom2.output.XMLOutputter;
import java.io.FileWriter;
public class JDOM2GenerateDemo {
public static void main(String[] args) {
try {
// 创建根节点
Element configElement = new Element("config");
// 创建子节点
Element dbElement = new Element("database");
Element hostElement = new Element("host");
hostElement.setText("127.0.0.1");
Element portElement = new Element("port");
portElement.setText("3306");
// 组装节点层级
dbElement.addContent(hostElement);
dbElement.addContent(portElement);
configElement.addContent(dbElement);
// 创建Document对象
Document document = new Document(configElement);
// 设置输出格式
Format format = Format.getPrettyFormat();
format.setEncoding("UTF-8");
XMLOutputter xmlOutputter = new XMLOutputter(format);
// 输出到文件
xmlOutputter.output(document, new FileWriter("config.xml"));
System.out.println("XML文件生成完成");
} catch (Exception e) {
e.printStackTrace();
}
}
}
JDOM2使用注意事项
- 解析大体积XML文件时，JDOM2会将整个树结构加载到内存中，可能会导致内存占用过高，这类场景建议选择SAX方式的解析库
- 如果需要使用XPath查询XML节点，JDOM2需要额外引入JAXEN依赖，添加<dependency> <groupId>jaxen</groupId> <artifactId>jaxen</artifactId> <version>1.2.0</version> </dependency>即可
- 生成XML文件时，建议显式设置编码格式，避免出现中文乱码问题
- 操作文件时注意捕获IO异常和解析异常，保证程序的健壮性