Tomcat 8 源碼編譯與 Eclipse 導入調試全流程

需修改 Tomcat 核心功能，必須編譯源碼並導入 Eclipse 調試。Tomcat 8 使用 Ant 建構。

1. 源碼編譯

1. 下載 apache-tomcat-8.0.x-src 解壓至 D:\apache-tomcat-8.0.5-src
2. 安裝 Ant 1.9+，配置 ANT_HOME、PATH
3. 修改 build.properties（從 build.properties.default 複製）：

base.path=D:/tomcat-deps  # 依賴包下載目錄
proxy.host=proxy.company.com  # 代理設定（如需）
proxy.port=8080
proxy.use=on

4. ant download 下載依賴
5. ant 編譯 → 生成 output/build/ 含 lib/、conf/

2. Eclipse 導入

1. 新建 Java Project：Tomcat8
2. 導入源碼：File → Import → File System 選擇源碼 java/、test/ → 勾選 Tomcat8 → Finish
3. 標記源碼目錄：右鍵 java/、test/ → Build Path → Use as Source Folder
4. 添加依賴庫：Build Path → Add External JARs 選擇 output/build/lib/ 下所有 JAR + junit.jar

3. Eclipse 中啟動 Tomcat

方案一：複製 lib/conf 到專案

將 output/build/lib、output/build/conf 複製到專案根目錄，運行 org.apache.catalina.startup.Bootstrap 主類。

方案二：VM 參數指定 catalina.home（推薦）

Run Configurations → Arguments → VM arguments:
-Dcatalina.home="D:/apache-tomcat-8.0.5-src/output/build"

直接運行 Bootstrap 類，控制台輸出啟動日誌，斷點生效。

4. 進階建構目標

• ant -f dist.xml dist-javadoc 生成 API 文檔
• ant -f extras.xml 編譯擴展模組（commons-logging、webservices）
• ant -f dist.xml release 生產發布包

修改源碼後只需重新執行 ant 增量編譯，Eclipse 熱部署即時生效。