在 Eclipse 中使用 Ant 靈活構建 Web 應用

前言

Ant 是 Java 開發者工具箱的關鍵一環，JUnit、XDoclet 等緊密依賴它。開發者可能習慣 IDE 自動構建與部署，而忽略 Ant 本身。主流 IDE 通常內建 Ant 任務完成這些工作，熟悉 Ant 內在機制，能閱讀或修改 build.xml，幫助更靈活地整合、管理專案。若要學習 Maven 這類開源專案管理解決方案，理解 Ant 更是基礎。此外，使用 Ant 過程實際上對構建進行了文檔化，且與 IDE 無關——團隊成員可能用 JBuilder、Eclipse 或其他工具。

筆者使用 Eclipse 3.0.1，先前構建部署由 MyEclipse 插件處理，趁週末實踐手動構建，記錄備忘。

實踐步驟

預備工作

習慣將所有公用類庫 JAR 放在固定目錄並分類（如 jakarta-commons、hibernate、spring、struts 等），源碼構建時需用到，部署時部分可能不需打包（如 servlet.jar）。若有自有框架也放此處。然後在 Eclipse 中「視窗」→「偏好設定」→「Java」→「User Libraries」新增自有庫（如 mylib），將公共 JAR 全部加入。好處：Eclipse 專案中不再顯示冗長 JAR 列表，較整潔。

正式進行

1. 新建 Java Project：不選 J2EE 插件內建選項，保持簡潔。
2. 建立目錄結構（常見於開源專案）：
   • src - 源碼
   • classes - 編譯輸出
   • web - JSP 等 Web 資源
   • lib - 庫，可從 mylib 複製，便於發布源碼
   • dlist - 輸出的 JAR 或 WAR
   當然要建 build.xml，Eclipse 會顯示螞蟻圖示。此檔建立後，後續專案可複製微調。
3. 專案屬性設定：「Java Build Path」的「庫」頁籤加入自定義公共庫 mylib。Builders 保持預設 Java Builder，平常除錯交給 IDE，部署時用 Ant。
4. 撰寫 build.xml（核心）：網上資源豐富，此處不贅述，基本分為幾個任務：
   • 4.1 宣告路徑變數：如 <property name="war.dir" value="dlist" />，也可寫在 properties 檔引用。
   • 4.2 宣告編譯類路徑：

     <path id="master-classpath">
         <fileset dir="${lib.root}/struts">
             <include name="struts-menu-2.3.jar" />
             <include name="struts.jar" />
         </fileset>
         <fileset dir="${lib.root}/jakarta-commons">
             <include name="commons-*.jar" />
         </fileset>
         <fileset dir="${lib.root}/ibatis2.0.9">
             <include name="ibatis-*.jar" />
         </fileset>
         <fileset dir="${lib.root}/jdbcdriver">
             <include name="jtds-0.9-rc2.jar" />
         </fileset>
         ......
     </path>

   • 4.3 清空輸出目錄（如 web、dlist 等）。
   • 4.4 編譯構建：javac 編譯源碼至 build.dir，複製 XML、properties 等資源檔，打包成 JAR 至 weblib.dir，再複製所需第三方 JAR 至同目錄。
   • 4.5 打包 WAR：使用 war 任務根據 web.xml 打包 Web 應用存檔。