JasperReport 實戰（一）：iReport 製作表格報表——從 XML 數據源到 PDF 輸出

環境與效果預覽

• 工具：iReport 3.0+ / Jaspersoft Studio 6+
• JDK：1.6+
• 效果：標準表格報表，含表頭、明細行、行號

步驟 1：準備 XML 數據源 (UTF-8 編碼)

    強尼男56
    阿美女23
    李麗女58
    傑森男32
    劉三男21

步驟 2：新建空白報表模板

File → New → Empty Report，命名 NameList.jrxml

步驟 3：添加標題靜態文本

• 拖拽 Static Text 到 Title 區域
• 屬性設置：字體 PMingLiu (需放入 iReport fonts 目錄) 或 宋體 + PDF Font STSong-Light
• 內容：人員名單表

步驟 4：創建子報表承載表格主體

表格主體放在子報表中，便於復用與數據源綁定：

1. Insert → Subreport 拖入 Detail 區域
2. 向導選擇 No Connection or Data Source，其餘默認
3. 生成 NameList_subreport0.jrxml

步驟 5：配置子報表區域

• 打開 NameList_subreport0.jrxml
• View → Bands 區域管理器：啟用 Column Header、Column Footer，高度設 20
• Column Header 放 3 個 Static Text：姓名、性別、年齡
• Detail 放 3 個 Text Field：$F{Name}、$F{Gender}、$F{Age}
• Column Footer 放 1 個 Text Field：$V{REPORT_COUNT} (行號)
• 所有元素設置邊框：Box → Pen 1px 實線

步驟 6：配置 XML Data Source

1. Data → Connections / Data Sources → New → XML Data Source
2. 文件路徑指向 NameList.xml
3. 勾選 Use the report XPath expression when filling the report

步驟 7：主報表查詢 XPath

Data → Report Query，XPath 填：/NameList/Person

步驟 8：主報表傳遞數據源給子報表

編輯子報表元素屬性 Connection/Data Source Expression：

((net.sf.jasperreports.engine.data.JRXmlDataSource)$P{REPORT_DATA_SOURCE})
    .dataSource("/NameList/Person")

步驟 9：子報表字段映射

1. 打開 NameList_subreport0.jrxml
2. Data → Report Query，XPath 填：/NameList/Person (相對路徑也可)
3. 報表檢視器左側樹右鍵節點 → Add node as field：Name、Gender、Age

步驟 10：綁定表達式

• 編輯 Detail 區域 Text Field：Expression 設置 $F{Name}、$F{Gender}、$F{Age}
• Column Footer 行號：$V{REPORT_COUNT}

步驟 11：編譯與預覽

1. Build → Compile 編譯兩個 .jrxml 為 .jasper
2. Build → Execute with active connection 帶數據源運行
3. 導出 PDF/HTML/Excel 驗證效果

源代碼下載

makeTableUsingIreport.rar

總結

iReport 製作表格報表核心流程：XML 數據源 → 子報表承載表格 → XPath 查詢綁定 → 字段映射 → 編譯預覽。關鍵技術點：JRXmlDataSource 數據源傳遞表達式、$V{REPORT_COUNT} 內置行號變量、字體配置 (PDF 中文支援)。掌握此流程，即可快速產出專業級表格報表。