在旧项目改造过程中，经常需要复用已有的XML配置文件。本文将介绍如何利用Dom4j库读取XML配置，并将其转换为Java对象。

技术背景

Dom4j是Java平台上的XML解析工具，它提供了高性能、功能全面的API来处理XML文档。相比于标准的DOM解析器，Dom4j在性能和易用性方面都有明显优势，被广泛应用于Hibernate等主流框架中。

实现步骤

1. 添加依赖

在Maven项目的pom.xml中引入Dom4j库：

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

2. 解析XML结构

以一个Struts框架的配置文件为例，目标是从XML中提取action配置信息。XML的主要结构如下：

• 根节点
• action-mappings子节点
• 每个action节点包含path、scope、parameter等属性
• action节点内可能包含forward子节点

需要构建两个Java对象：ActionConfig（保存action配置）和ForwardConfig（保存forward配置）。ActionConfig的forwards属性将存储多个ForwardConfig实例。

3. 实现代码

void parseXmlToConfigObjects(String xmlFilePath) throws IOException, DocumentException {
    log.info("正在解析配置文件：{}", xmlFilePath);
    
    SAXReader xmlReader = new SAXReader();
    Document xmlDoc = xmlReader.read(new File(xmlFilePath));
    
    // 获取文档根元素
    Element rootElement = xmlDoc.getRootElement();
    
    // 定位到action-mappings节点并遍历所有action子元素
    Element mappingsElement = rootElement.element("action-mappings");
    Iterator<Element> actionIterator = mappingsElement.elementIterator("action");
    
    while (actionIterator.hasNext()) {
        Element actionElement = actionIterator.next();
        ActionConfig actionConfig = new ActionConfig();
        
        // 处理action节点的所有属性
        List<Attribute> actionAttrs = actionElement.attributes();
        for (Attribute attr : actionAttrs) {
            String attrName = attr.getName();
            String attrValue = attr.getValue();
            
            switch (attrName) {
                case "path":
                    actionConfig.setName(attrValue + ".do");
                    actionConfig.setPath(attrValue);
                    break;
                case "scope":
                    actionConfig.setScope(attrValue);
                    break;
                case "parameter":
                    actionConfig.setParameter(attrValue);
                    break;
                default:
                    break;
            }
        }
        
        // 处理forward子节点
        List<Element> forwardElements = actionElement.elements("forward");
        if (forwardElements != null && !forwardElements.isEmpty()) {
            for (Element forwardEl : forwardElements) {
                ForwardConfig forwardConfig = new ForwardConfig();
                List<Attribute> forwardAttrs = forwardEl.attributes();
                
                for (Attribute attr : forwardAttrs) {
                    String attrName = attr.getName();
                    String attrValue = attr.getValue();
                    
                    switch (attrName) {
                        case "path":
                            forwardConfig.setPath(attrValue.replace(".jsp", ""));
                            break;
                        case "name":
                            forwardConfig.setName(attrValue);
                            break;
                        case "module":
                            forwardConfig.setModule(attrValue);
                            break;
                        default:
                            break;
                    }
                }
                actionConfig.getForwards().put(forwardConfig.getName(), forwardConfig);
            }
        }
        
        configMap.put(actionConfig.getName(), actionConfig);
    }
    
    log.info("解析完成，共提取{}个action配置", configMap.size());
}

4. 运行结果

执行上述代码后，所有action配置将被正确解析，并生成对应的ActionConfig对象实例。

应用场景

基于Dom4j的XML解析方案适用于系统重构场景，特别是需要将传统Struts框架配置迁移到Spring MVC等现代框架时，能够有效复用既有配置文件，减少重复编码工作。