Java 實戰：從 XML 數據源動態生成業務圖表服務

背景與挑戰：數據可視化的「最後一公里」

市面上圖表庫（如 JFreeChart、ECharts）功能強大，但普遍要求數據符合特定格式。現實中，XML 數據源往往來自第三方系統、結構千差萬別，強行轉換格式（常用 XSLT）不僅增加開發負擔，還掩蓋了 XML 本身的靈活優勢。本文示範如何構建一個通用圖表服務：直接讀取任意 XML，透過 XPath 動態提取數據系列與類別，調用 JFreeChart 生成圖片，最後以 JPEG 形式輸出給瀏覽器——無需客戶端安裝任何插件。

核心概念：數據系列與類別系列

• 數據系列：一組關聯的數值點。折線圖中是線上的點，餅圖中是每塊扇區的數值。
• 類別系列：描述數據系列的標籤。折線圖中常為時間軸，餅圖中為圖例名稱。

複雜圖表可包含多組數據系列（如預算收入 vs 實際收入），配置文件分離了數據源位置、XPath 提取規則、圖表尺寸、樣式配置，實現「配置即代碼」。

配置文件設計：charts.xml 與 pmconfig.xml

charts.xml —— 圖表元數據定義

<chart id="points">
  <url>https://localhost/players.xml</url>
  <config>https://localhost/pmconfig.xml</config>
  <series>//Players/Player[Points>0 and Minutes>1000]/Points</series>
  <categories>//Players/Player[Points>0 and Minutes>1000]/Name</categories>
  <XSize>600</XSize>
  <YSize>400</YSize>
</chart>

XPath 支持豐富過濾條件（如得分>0 且上場>1000 分鐘），極大提升數據提取靈活性。

pmconfig.xml —— 圖表外觀配置

<chart>
  <Type>1</Type> <!-- 1=餅圖, 2=柱狀圖... -->
  <Title>Points By Player</Title>
  <CatTitle>Player Name</CatTitle>
  <ValTitle>Points</ValTitle>
  <SeriesTitles>Points Scored</SeriesTitles>
</chart>

系列標題、顏色、圖例等樣式均外部化，修改無需重編譯。

Servlet 核心流程：DoChart 引擎

1. doGet() 解析請求參數（chartId、寬高），加載 charts.xml 獲取對應配置。
2. 根據配置下載 XML 數據源與樣式配置文件。
3. 調用 DoChart() 執行核心邏輯：

// 伪代碼示意
Document dataDoc = loadXML(dataUrl);
Document cfgDoc  = loadXML(configUrl);

NodeList seriesNodes = xpathEval(dataDoc, seriesXPath);
NodeList catNodes    = xpathEval(dataDoc, catXPath);

DefaultPieDataset dataset = new DefaultPieDataset();
for (int i=0; i<seriesNodes.getLength(); i++) {
    dataset.setValue(catNodes.item(i).getTextContent(),
                     Double.parseDouble(seriesNodes.item(i).getTextContent()));
}

JFreeChart chart = ChartFactory.createPieChart(
    cfgDoc.getTitle(), dataset, true, true, false);
// 應用顏色、字體、圖例等樣式...
ChartUtilities.writeChartAsJPEG(response.getOutputStream(), chart, width, height);

擴展性設計：從固定文件到動態數據服務

初版 ChartServer 讀取固定 XML 文件。生產環境可擴展為：

• 數據源改為 JDBC 查詢、REST API、消息隊列等任意來源。
• 引入參數化 XPath：//Order[@customerId=$custId]/Amount，由請求參數動態綁定。
• 圖表引擎抽象為 ChartRenderer 接口，輕鬆切換 JFreeChart、ECharts 服務端渲染、Apache ECharts 等實現。

部署與效能考量

• 緩存策略：對相同參數請求緩存生成的 JPEG，配合 ETag/Last-Modified 減少重複渲染。
• 線程安全：JFreeChart 非線程安全，每次請求創建新實例或使用對象池。
• 大數據集：採用流式 XPath（如 VTD-XML）或預聚合數據，避免將海量 XML 全量載入內存。

總結

這套「XML + XPath + JFreeChart」架構，以配置驅動替代硬編碼轉換，保留了 XML 的靈活性，同時屏蔽了圖表庫的複雜 API。它是構建企業級報表門戶、儀表盤後端的輕量級起點，擴展性強、維護成本低，極適合敏捷迭代場景。