JFreeChart 整合 Tomcat 完整配置指南 (環境變量、Servlet 註冊、依賴管理)

前言

JFreeChart 是經典 Java 圖表庫，整合到 Web 應用需解決依賴傳遞、Servlet 註冊、類路徑隔離三大問題。本文以 JFreeChart 1.0.10 + Tomcat 5.0 + JDK 1.4 為例，梳理生產環境可用的配置全流程，新版本 (JFreeChart 1.5.x、Tomcat 9/10、JDK 11/17) 同理可循。

一、 依賴庫準備 (Maven 化強烈推薦)

手動部署： 將上述 JAR 放入專案 WEB-INF/lib/ (推薦，實現應用級隔離) 或 Tomcat 共享 common/lib/ (易發生版本衝突，不推薦)。

二、 環境變量配置 (僅傳統非 Maven 專案需手動)

# Linux/Unix ~/.bashrc 或 /etc/profile
export JAVA_HOME=/usr/java/jdk1.4.2_11
export CATALINA_HOME=/opt/tomcat5
export CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar:$CATALINA_HOME/common/lib/servlet-api.jar:$CATALINA_HOME/common/lib/jsp-api.jar:$JAVA_HOME/lib/jfreechart-1.0.10.jar

# Windows 系統環境變量
JAVA_HOME=C:\Java\jdk1.4.2_11
CATALINA_HOME=C:\Tomcat5
CLASSPATH=.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar;%CATALINA_HOME%\common\lib\servlet-api.jar;%CATALINA_HOME%\common\lib\jsp-api.jar;%JAVA_HOME%\lib\jfreechart-1.0.10.jar
Path 追加 %JAVA_HOME%\bin;%CATALINA_HOME%\bin

注意： 生產環境極不建議依賴系統 CLASSPATH，應由構建工具 (Maven/Gradle) 打包進 WAR 的 WEB-INF/lib，由 WebAppClassLoader 隔離加載。

三、 web.xml 註冊 DisplayChart Servlet

JFreeChart 提供 org.jfree.chart.servlet.DisplayChart 用於在 Web 頁面直接輸出圖片 (PNG/JPEG)。

<servlet>
  <servlet-name>DisplayChart</servlet-name>
  <servlet-class>org.jfree.chart.servlet.DisplayChart</servlet-class>
  <load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
  <servlet-name>DisplayChart</servlet-name>
  <url-pattern>/servlet/DisplayChart</url-pattern>
</servlet-mapping>

用法： JSP/HTML 中 <img src="/servlet/DisplayChart?chart=...&width=500&height=300" />，參數詳見 JFreeChart 文檔 ChartUtilities。

四、 現代化最佳實踐 (Spring Boot + JFreeChart 1.5.x)

// pom.xml
<dependency>
  <groupId>org.jfree</groupId>
  <artifactId>jfreechart</artifactId>
  <version>1.5.4</version>
</dependency>

// Controller
@RestController
@RequestMapping("/api/charts")
public class ChartController {
    @GetMapping("/bar")
    public void barChart(HttpServletResponse response) throws IOException {
        // 1. 建立數據集
        DefaultCategoryDataset dataset = new DefaultCategoryDataset();
        dataset.addValue(10, "Series1", "Jan");
        dataset.addValue(20, "Series1", "Feb");
        // 2. 創建圖表
        JFreeChart chart = ChartFactory.createBarChart("Title", "Category", "Value", dataset, PlotOrientation.VERTICAL, true, true, false);
        // 3. 輸出 PNG
        response.setContentType("image/png");
        ChartUtils.writeChartAsPNG(response.getOutputStream(), chart, 600, 400);
    }
}

優勢：無需額外 Servlet 註冊、依賴傳遞自動化、單元測試容易、容器化部署無感知。

五、 常見問題排查

結語

JFreeChart 整合核心在於依賴隔離 (WEB-INF/lib)、Servlet 正確註冊、中文字體顯式設置。新專案請直接採用 Spring Boot + Maven/Gradle 管理依賴，棄用系統 CLASSPATH 與手動 web.xml 註冊，擁抱現代化構建與部署流程。