萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

Java 使用 JDOM 解析 XML 完整教學:從入門到 Spring 風格 BeanFactory 實作

前言

JDOM 是 Java 操作 XML 的經典庫(現建議改用 DOM4J 或標準 javax.xml.parsers),但理解其樹狀模型與 XPath 查詢對維護舊系統仍有價值。本文以「Spring 風格 BeanFactory」為例,完整示範 JDOM 解析、XPath 查詢、反射實例化全流程。

專案結構

src/
├── com/njupt/zhb/test/
│   ├── Moveable.java          # 介面
│   ├── Plane.java             # 實作類
│   ├── Train.java             # 實作類
│   ├── BeanFactory.java       # Bean 工廠介面
│   ├── ClassPathXmlApplicationContext.java  # JDOM 解析核心
│   └── TestMain.java          # 測試入口
└── sample.xml                 # XML 設定檔

核心類別程式碼

1. 介面與實作類

// Moveable.java
public interface Moveable { void run(); }

// Plane.java
public class Plane implements Moveable {
    public void run() { System.out.println("飛機在翱翔....."); }
}

// Train.java
public class Train implements Moveable {
    public void run() { System.out.println("火車在飛奔...."); }
}

2. BeanFactory 介面

public interface BeanFactory {
    Object getBean(String id);
}

3. XML 設定檔 (sample.xml)

<?xml version="1.0" encoding="UTF-8"?>
<beans>
    <bean id="train" class="com.njupt.zhb.test.Train" />
    <bean id="plane" class="com.njupt.zhb.test.Plane" />
</beans>

4. JDOM 解析核心:ClassPathXmlApplicationContext

import org.jdom.Document;
import org.jdom.Element;
import org.jdom.input.SAXBuilder;
import org.jdom.xpath.XPath;
import java.util.*;

public class ClassPathXmlApplicationContext implements BeanFactory {
    private Map<String, Object> beanContainer = new HashMap<>();

    public ClassPathXmlApplicationContext(String fileName) throws Exception {
        // 1. 建立 SAXBuilder
        SAXBuilder sb = new SAXBuilder();

        // 2. 從 classpath 載入 XML
        Document doc = sb.build(this.getClass().getClassLoader()
            .getResourceAsStream(fileName));

        // 3. 取得根元素
        Element root = doc.getRootElement();

        // 4. XPath 查詢所有 bean 節點
        List<Element> beanElements = XPath.selectNodes(root, "/beans/bean");

        // 5. 遍歷解析、反射實例化、註冊
        for (Element bean : beanElements) {
            String id = bean.getAttributeValue("id");
            String className = bean.getAttributeValue("class");

            // 反射建立實例
            Object instance = Class.forName(className).newInstance();

            // 註冊到容器
            beanContainer.put(id, instance);
            System.out.println("註冊 Bean: " + id + " -> " + className);
        }
    }

    @Override
    public Object getBean(String id) {
        return beanContainer.get(id);
    }
}

5. 測試主程式

public class TestMain {
    public static void main(String[] args) throws Exception {
        BeanFactory factory = new ClassPathXmlApplicationContext(
            "com/njupt/zhb/test/sample.xml"
        );

        Moveable train = (Moveable) factory.getBean("train");
        train.run(); // 輸出:火車在飛奔....

        Moveable plane = (Moveable) factory.getBean("plane");
        plane.run(); // 輸出:飛機在翱翔.....
    }
}

JDOM 關鍵 API 速查

類別/方法用途
SAXBuilder.build(InputStream)解析 XML 輸入流建立 Document
Document.getRootElement()取得根元素
Element.getAttributeValue(name)取得屬性值
Element.getChildren(name)取得子元素列表
XPath.selectNodes(context, path)XPath 查詢節點列表
XPath.selectSingleNode(context, path)XPath 查詢單一節點
XMLOutputter.output(doc, OutputStream)輸出 XML 到流

常見問題與遷移建議

  • JDOM 1.x vs 2.x:JDOM 2.x 需 Java 6+,套件名從 org.jdom 改為 org.jdom2,Maven 坐標變更。
  • XPath 依賴:JDOM 1.x 內建 XPath,2.x 需額外引入 jaxen 套件。
  • 命名空間處理:XML 有命名空間時,XPath 需註冊 NamespaceContext,較繁瑣。
  • 現代替代方案:
    • 標準 API:javax.xml.parsers.DocumentBuilder + XPathFactory(零依賴)
    • DOM4J:API 更豐富、效能更好、支援 XPath 2.0
    • Jackson XML:XmlMapper 直接映射為 POJO,適合配置檔綁定

總結

JDOM 以純 Java、樹狀模型、XPath 支援簡化 XML 操作。本範例展示了「設定檔 → 解析 → 反射實例化 → 容器註冊」的完整 IoC 雛形流程。現代專案建議遷移至標準 API 或 Jackson XML,但理解 JDOM 思維有助於閱讀舊系統原始碼。

copyright © 萬盛學電腦網 all rights reserved