学习使用 dom4j 进行 XML 处理

在 Java 开发中，处理 XML 文件是一项非常常见的任务。dom4j 是一个非常强大的库，可以帮助我们简化 XML 的读取、创建和修改。本文将一步一步指导你如何在 Java 项目中使用 dom4j。

整体流程

以下是使用 dom4j 的整体步骤：

步骤 描述
1 添加 dom4j 依赖
2 创建一个 XML 文件
3 加载 XML 文件
4 读取 XML 数据
5 修改 XML 数据
6 保存 XML 文件

具体步骤

1. 添加 dom4j 依赖

首先，你需要在项目中引入 dom4j 库。假设你在使用 Maven，可以在 pom.xml 中添加如下依赖：

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

2. 创建一个 XML 文件

在项目的资源文件夹中创建一个名为 books.xml 的 XML 文件。内容示例：

<library>
    <book>
        <title>Learn Java</title>
        <author>John Doe</author>
        <year>2020</year>
    </book>
    <book>
        <title>Learn dom4j</title>
        <author>Jane Doe</author>
        <year>2021</year>
    </book>
</library>

3. 加载 XML 文件

接下来，我们可以开始编写 Java 代码来加载这个 XML 文件。

import org.dom4j.Document;
import org.dom4j.io.SAXReader;

import java.io.File;

public class XMLLoader {
    public static Document loadXML(String filePath) throws Exception {
        SAXReader reader = new SAXReader(); // 创建 SAXReader 对象
        Document document = reader.read(new File(filePath)); // 读取 XML 文件并返回 Document 对象
        return document; // 返回加载的 Document
    }
}

4. 读取 XML 数据

现在，我们可以读取 XML 中的数据。以下代码展示如何遍历 XML 文件并读取书籍信息。

import org.dom4j.Document;
import org.dom4j.Element;

import java.util.List;

public class XMLReader {
    public static void readXML(Document document) {
        Element root = document.getRootElement(); // 获取根元素
        List<Element> books = root.elements("book"); // 获取所有 book 元素

        for (Element book : books) {
            String title = book.elementText("title"); // 获取书名
            String author = book.elementText("author"); // 获取作者
            String year = book.elementText("year"); // 获取出版年份

            System.out.println("Title: " + title + ", Author: " + author + ", Year: " + year); // 打印书籍信息
        }
    }
}

5. 修改 XML 数据

接下来，我们演示如何修改 XML 文件的内容。例如，我们想给每本书增加一本价格：

public class XMLModifier {
    public static void modifyXML(Document document, String title, double price) {
        List<Element> books = document.getRootElement().elements("book"); // 获取所有 book 元素

        for (Element book : books) {
            if (book.elementText("title").equals(title)) {
                Element priceElement = book.addElement("price"); // 增加 price 元素
                priceElement.setText(String.valueOf(price)); // 设置价格文本
            }
        }
    }
}

6. 保存 XML 文件

最后，我们将修改后的 XML 文件保存回硬盘上：

import org.dom4j.io.OutputFormat;
import org.dom4j.io.XMLWriter;

import java.io.FileWriter;

public class XMLSaver {
    public static void saveXML(Document document, String filePath) throws Exception {
        OutputFormat format = OutputFormat.createPrettyPrint(); // 创建漂亮格式
        XMLWriter writer = new XMLWriter(new FileWriter(filePath), format); // 创建 XMLWriter
        writer.write(document); // 写入 Document 到文件
        writer.close(); // 关闭 writer
    }
}

类图

下面是本示例中所有类的类图：

classDiagram
    class XMLLoader {
        +Document loadXML(String filePath)
    }
    class XMLReader {
        +void readXML(Document document)
    }
    class XMLModifier {
        +void modifyXML(Document document, String title, double price)
    }
    class XMLSaver {
        +void saveXML(Document document, String filePath)
    }

结尾

通过以上步骤，我们学习了如何使用 dom4j 来处理 XML 文件。我们首先添加了库依赖，创建了 XML 文件，然后逐步实现了加载、读取、修改和保存 XML 文件的功能。相信经过这样的练习，你将对 dom4j 有一个全面的了解，可以灵活应用于实际项目中。希望这篇文章能帮助你顺利入门 XML 处理！