jdom2 是轻量易用的 java xml 处理库，核心流程为构建—解析—修改—输出；支持 xpath、命名空间和格式化输出，需使用 2.0.6 版本并注意与 jdom1 不兼容。
JDOM2 是 Java 中一个轻量、易用的 XML 处理库，专为开发者友好设计，相比 DOM 更简洁，比 SAX 更直观。它不依赖于 JAXP 或其他底层解析器（但默认使用 Xerces），支持 XPath、命名空间、XML 输出格式控制等常用功能。入门其实不难，关键抓住“构建—解析—修改—输出”四步主线。
快速开始：添加依赖
如果你用 Maven，在 pom.xml 中加入：
注意：JDOM2 的最新稳定版是 2.0.6（截至 2024 年），不要误用老版本 jdom（1.x）——两者不兼容。
立即学习“Java免费学习笔记（深入）”；
读取 XML 文件并解析成 Document
用 SAXBuilder 是最常用方式，它默认使用高效、标准的 SAX 解析器构建 JDOM 结构：
- 创建 SAXBuilder 实例（可复用，线程安全）
- 调用 build(File/InputStream/String) 得到 Document
- 从 Document 获取根 Element：document.getRootElement()
示例代码：
享有盛誉的PHP高级教程，Zend Framework核心开发人员力作，深入设计模式、PHP标准库和JSON 。 今天，PHP已经是无可争议的Web开发主流语言。PHP 5以后，它的面向对象特性也足以与Java和C#相抗衡。然而，讲述PHP高级特性的资料一直缺乏，大大影响了PHP语言的深入应用。 本书填补了这一空白。它专门针对有一定经验的PHP程序员，详细讲解了对他们最为重要的主题
SAXBuilder builder = new SAXBuilder();
Document doc = builder.build(new File("config.xml"));
Element root = doc.getRootElement();
System.out.println("根元素名：" + root.getName());
遍历与查找元素（含 XPath 支持）
JDOM2 内置 XPath 支持，比手写递归遍历更清晰：
- 用 XPathFactory.instance().compile("//user") 编译表达式
- 调用 evaluate(root) 返回 List
- 也支持带命名空间的 XPath（需注册 Namespace 对象）
- 简单查找可用 getChild("name") 或 getChildren("item")
例如提取所有邮箱：
XPathExpression
.compile("//contact/email", Filters.element());
List
for (Element e : emails) {
System.out.println(e.getTextTrim());
}
创建和修改 XML 并保存
新建 XML 可直接构造 Element 和 Document：
- Element user = new Element("user").setAttribute("id", "101");
- user.addContent(new Element("name").setText("张三"));
- Document doc = new Document(user);
- 用 XMLOutputter 格式化输出：
new XMLOutputter(Format.getPrettyFormat()).output(doc, System.out);
修改现有内容也很直接：element.setText("新值")、element.setAttribute("status", "active")、element.removeChildren("temp") 等。
小贴士：常见注意事项
- Element 的 getText() 返回含空白文本，建议用 getTextTrim() 去首尾空格
- 处理中文时确保输入流指定正确编码（如 new FileInputStream(f, "UTF-8")）
- XMLOutputter 默认不缩进，用 Format.getPrettyFormat() 启用美化输出
- 若 XML 含 DTD 或 XSD 验证需求，SAXBuilder 可设置 setValidation(true)，但多数场景无需开启
