Eclipse RCP 整合 JasperReports 實現客戶端報表

架構設計

早期 RCP 缺乏 BIRT 整合，採用客戶端參數收集 → 服務端渲染 → 客戶端顯示架構：

1. 報表模板（.jrxml）存放於服務端資源目錄。
2. 客戶端收集用戶輸入參數、模板名稱，提交 Request。
3. 服務端注入數據源、參數，調用 JasperReports 引擎生成 .jrprint。
4. 服務端返回 jrprint 字節流。
5. 客戶端寫入臨時文件，通過 SWT_AWT 橋接器嵌入 JRViewer（Swing 組件）顯示。

關鍵技術點

SWT/AWT 橋接

Composite composite = new Composite(parent, SWT.EMBEDDED | SWT.NO_BACKGROUND);
Frame frame = SWT_AWT.new_Frame(composite);
frame.add(new JRViewer(jasperPrint));

服務端報表生成

JasperPrint jasperPrint = JasperFillManager.fillReport(
    jasperReport, parameters, dataSource); // dataSource 可為 Connection 或 JRBeanCollectionDataSource
byte[] bytes = JasperExportManager.exportReportToPdf(jasperPrint); // 或 exportToXml
return bytes;

通訊協議

自定義 TCP Client/Server，採用值拷貝序列化（預設兩層），避免 Hibernate 代理物件序列化導致整庫傳輸。特殊場景通過約定參數控制傳輸深度。

效果展示

註：截圖中漏斗圖為自繪控件，非 JasperReports 內建。

經驗總結

• 想清楚再動手：架構清晰則開發極快（本案 3 小時完成）。
• 報表模板與數據邏輯分離，服務端統一管理。
• 客戶端僅負責參數收集與顯示，輕量化。
• 若現代專案，優先考慮 BIRT 或 Web 報表方案（如 JasperServer）。