JasperReport 實戰（三）：XPath 查詢 XML 數據源完全指南

為什麼選 XML + XPath？

• 結構清晰、可讀性強，適合「報表數據 = 文件」交付場景
• 避免 SQL 耦合，面向對象思維：對象 → XML → 報表
• XPath 標準化查詢語法，學習成本低

XPath 基礎語法速查

實戰數據源 (NameList.xml)

<NameList>
    <Person><Name>強尼</Name><Gender>男</Gender><Age>56</Age></Person>
    <Person><Name>阿美</Name><Gender>女</Gender><Age>23</Age></Person>
    <Person><Name>李麗</Name><Gender>女</Gender><Age>58</Age></Person>
    <Person><Name>傑森</Name><Gender>男</Gender><Age>32</Age></Person>
    <Person><Name>劉三</Name><Gender>男</Gender><Age>21</Age></Person>
</NameList>

常用 XPath 查詢示例

// 1. 選取所有 Person 節點 (作為報表主查詢)
/NameList/Person

// 2. 相對路徑：在 Person 上下文中選取 Name
Name

// 3. 絕對路徑選取所有 Name
/NameList/Person/Name

// 4. 條件查詢：年齡 < 50 的 Person
/NameList/Person[Age < 50]

// 5. 條件查詢：性別為女的 Person
/NameList/Person[Gender = '女']

// 6. 第一條記錄
/NameList/Person[1]

// 7. 前兩條記錄
/NameList/Person[position() <= 2]

// 8. 統計 Person 總數
count(/NameList/Person)

iReport/Jaspersoft Studio 配置步驟

1. 建立 XML Data Source：Data → Connections / Data Sources → New → XML Data Source
2. 指向 XML 文件，勾選 Use the report XPath expression when filling the report
3. 報表查詢對話框 (Data → Report Query) 設置 XPath 查詢語句 (如 /NameList/Person)
4. 子報表連接表達式：((JRXmlDataSource)$P{REPORT_DATA_SOURCE}).dataSource("相對XPath")
5. 字段映射：右鍵節點 → Add node as field，自動生成 $F{fieldName}

Java 代碼填充報表

public void fillReport() throws JRException {
    // 1. 數據源
    JRXmlDataSource dataSource = new JRXmlDataSource(new File("NameList.xml"));
    // 2. 參數
    Map params = new HashMap<>();
    // 3. 填充
    JasperPrint print = JasperFillManager.fillReport("Report.jasper", params, dataSource);
    // 4. 導出
    JasperExportManager.exportReportToPdfFile(print, "output.pdf");
}

總結

XPath 是 JasperReport 處理 XML 數據源的核心查詢語言。掌握絕對/相對路徑、條件謂詞、position()、count()等常用語法，配合 iReport 可視化字段映射，即可高效完成「XML → 報表」轉換。關鍵技巧：REPORT_COUNT 變量配合動態 XPath 實現子報表數據源精準定位。