Java 後端整合 FusionCharts 前端圖表庫完整實作指南
本文詳細解析如何在 JSP/Java 環境中整合 FusionCharts (而非 JFreeChart,原文標題存疑) 實現柱狀圖、餅圖、折線圖等資料視覺化展示,涵蓋前後端資料流、XML/JSON 資料格式、圖表配置與常見問題。
技術架構釐清
- JFreeChart:Java 端生成圖片的伺服器端圖表庫,輸出 PNG/JPG
- FusionCharts:JavaScript 前端圖表庫,瀏覽器端渲染 SVG/VML,互動性強
- 原文實際使用:FusionCharts (JS) + JSP 後端產出 XML 資料
完整整合實作流程
1. 前端引入 FusionCharts 核心檔案
<head>
<!-- FusionCharts 核心 (版本 3.x 語法) -->
<script type="text/javascript" src="/js/FusionCharts.js"></script>
<!-- 若使用舊版 ChartObject 輔助類 -->
<script type="text/javascript" src="/js/ChartObject.js"></script>
</head>
2. JSP 頁面容器與初始化
<body onload="init()">
<!-- 圖表渲染容器 -->
<div style="margin-top:3px; margin-left:3px;">
<span id="chartDiv2" style="width:100%;"></span>
</div>
</body>
3. 後端資料準備 (Servlet/Controller)
// Java Servlet / Controller 範例
@WebServlet("/chartData")
public class ChartDataServlet extends HttpServlet {
protected void doGet(HttpServletRequest req, HttpServletResponse resp) {
// 1. 從資料庫/服務獲取原始資料
List stats = accountService.getCarrierStats();
// 2. 組裝前端所需格式
String names = stats.stream().map(s -> s.getName()).collect(Collectors.joining(","));
String values = stats.stream().map(s -> String.valueOf(s.getRate())).collect(Collectors.joining(","));
String labels = stats.stream().map(s -> s.getLabel()).collect(Collectors.joining(","));
// 3. 存入 request 屬性供 JSP 使用
req.setAttribute("accountlist.name", names);
req.setAttribute("accountlist.values", values);
req.setAttribute("accountlist.valueshb", labels);
// 4. 轉發至 JSP
req.getRequestDispatcher("/chart.jsp").forward(req, resp);
}
}
4. JSP 中 JavaScript 圖表渲染邏輯
<script>
function init() {
// 從 JSP EL 表達式獲取後端資料
var names = "<%=request.getAttribute(\"accountlist.name\")%>";
var rates = "<%=request.getAttribute(\"accountlist.valueshb\")%>";
// 呼叫圖表渲染
showChart4(names, rates);
}
function showChart4(names, values) {
// 1. 建立圖表配置物件 (ChartObject 為自定義輔助類)
var chartObj = new ChartObject();
// 2. 設定圖表屬性
chartObj.caption = "各承運單位車輛銷運比圖";
chartObj.showValues = '0'; // 不顯示數值
chartObj.showLabels = '1'; // 顯示標籤
chartObj.sNumberSuffix = '%25'; // 後綴 % (URL 編碼)
// 3. 生成 XML 資料字串 (FusionCharts 3.x 使用 XML)
var xmlString = chartObj.createDualYMSColumnXmlByValues(
names, // 類別名稱 (逗號分隔)
values, // 數值 (逗號分隔)
"", // 第二組數值 (雙Y軸用)
"銷運比=銷量%運力", // 圖例說明
"" // 額外參數
);
// 4. 建立圖表實例並渲染
var chart = new FusionCharts(
"Charts/MSColumn3DLineDY.swf", // SWF 檔案路徑 (舊版 FusionCharts 使用 Flash)
"ChartId2", // 圖表 ID
"1000", "230", // 寬、高
"0", "0" // Debug 模式、註冊模式
);
chart.setDataXML(xmlString);
chart.render("chartDiv2"); // 目標容器 ID
}
</script>
現代化遷移:FusionCharts 現代版 (v3.12+ 純 JS、無 Flash)
資料格式轉換工具函式
/**
* 將後端 List
常見圖表類型對照 (FusionCharts 別名)
| 類型 | FusionCharts 別名 | 適用場景 |
| 柱狀圖 | column2d, column3d, mscolumn2d, mscolumn3d | 類別比較、趨勢 |
| 長條圖 | bar2d, bar3d, msbar2d, msbar3d | 長標籤類別 |
| 折線圖 | line, msline, spline, msspline | 時間序列趨勢 |
| 面積圖 | area2d, msarea, msstackedarea2d | 累積量趨勢 |
| 餅圖 | pie2d, pie3d, doughnut2d, doughnut3d | 佔比關係 |
| 雙Y軸混合 | mscolumn2dlinedy, mscolumn3dlinedy, mscombi2d, mscombi3d | 不同量級指標對比 |
| 散佈圖 | scatter | 相關性分析 |
| 熱力圖 | heatmap | 矩陣密度 |
效能優化與最佳實踐
- 資料量控制:單圖表超過 1000 點建議採樣或分頁
- 懶載入:IntersectionObserver 監測容器進入視口再渲染
- 快取策略:靜態圖表資料加上 ETag/Last-Modified
- 響應式:容器
width: 100% + chart.resizeTo() 監聽 resize
- 銷毀機制:SPA 路由切換時呼叫
chart.dispose() 釋放記憶體
替代方案:開源免費圖表庫
| 庫 | 特色 | 授權 | 體積 |
| ECharts | 功能最全、百度維護、生態豐富 | Apache 2.0 | ~500KB |
| Chart.js | 簡單易用、Canvas、動畫流暢 | MIT | ~60KB |
| ApexCharts | 現代 API、動畫豐富、Vue/React 官方包裝 | MIT | ~200KB |
| Recharts | React 原生、組件化、D3 底層 | MIT | ~150KB |
| Highcharts | 企業級、無障礙完善、功能最強 | 商業/免費非商業 | ~200KB |