JFreeChart 實戰教程 (一)：快速入門與核心架構總覽

JFreeChart 簡介

JFreeChart 是 JFree 組織開發的 Java 圖表庫，支援豐富圖表類型：

• 餅圖、柱狀圖 (一般/堆疊)、折線圖、區域圖、散佈圖、混合圖
• 甘特圖、儀表盤、K 線圖、氣泡圖、風向圖、象限圖等專業圖表

官網：https://jfree.org/

核心使用模式

1. ChartFactory 靜態工廠方法建立 JFreeChart 物件
2. ChartUtilities 將圖表匯出為圖片 (PNG/JPEG) 或直接在 Swing 面板顯示
3. Servlet 輸出圖片流亦常見用法

架構複雜度與痛點

• 資料模型碎片化： 每種圖表需特定 Dataset (PieDataset/CategoryDataset/XYDataset...) 與 Plot 類型對應，開發者必須記憶對應關係
• 工廠模式擴展困難： 多種 Dataset/Plot 分散在多包中，查找成本高
• 中文亂碼： 預設字體不支援中文，需全域設定標籤字體 (如 ChartFactory.setChartTheme(new StandardChartTheme("CN")) 或手動設定各文字元件字體)

CEWolf 標籤庫

提供 JSP Taglib 封裝，可在頁面以標籤方式生成圖表，降低 Java 代碼耦合。

ChartFactory 靜態工廠方法完整清單

// Pie
createPieChart, createMultiplePieChart, createPieChart3D, createMultiplePieChart3D, createRingChart

// Bar
createBarChart, createStackedBarChart, createBarChart3D, createStackedBarChart3D

// Area
createAreaChart, createStackedAreaChart

// Line
createLineChart, createLineChart3D

// Gantt / Special
createGanttChart, createWaterfallChart, createPolarChart, createScatterPlot

// XY Series
createXYBarChart, createXYAreaChart, createStackedXYAreaChart
createXYLineChart, createXYStepChart, createXYStepAreaChart

// Time Series / Financial
createTimeSeriesChart, createCandlestickChart, createHighLowChart

// Statistical / Map
createBubbleChart, createHistogram, createBoxAndWhiskerChart
createWindPlot, createWaferMapChart

學習建議

1. 先掌握「Dataset → Factory → Chart → Plot → Renderer」核心鏈路
2. 從 DefaultCategoryDataset + createBarChart/LineChart/PieChart 入手
3. 遇到客製化需求時，查閱對應 Plot 與 Renderer 類別
4. 中文問題優先解決：專案啟動即設定全域字體主題