您现在的位置：程式碼之家 >> 編程語言 > >> Java 程式設計 >> Java 相關知識

Eclipse 中靈活運用 Ant 構建 Web 應用：從專案結構到打包部署

編輯：Java 相關知識

Ant 是 Java 建構自動化的基石，IDE 內建建構往往掩蓋細節。本文實戰示範在 Eclipse 中手動配置 Ant 建構腳本，實現原始碼編譯、資源複製、單元測試、JAR/WAR 打包、API 文檔生成全流程自動化，打造 IDE 無關的標準化建構體系。

專案目錄結構規範


project-root/
├── src/           # Java 原始碼
├── classes/       # 編譯輸出
├── web/           # Web 資源 (JSP, HTML, CSS, JS, web.xml)
├── lib/           # 專案級相依 JAR (發布用)
├── dlist/         # 建構輸出 (JAR, WAR)
├── build.xml      # Ant 建構腳本
└── build.properties # 環境變數外部化 (可選)

Eclipse 環境預配置

使用者程式庫：`Window → Preferences → Java → User Libraries` 建立 `mylib`，集中管理 Jakarta Commons、Hibernate、Spring、Struts 等共用 JAR，專案僅引用 Library，保持 Build Path 乾淨
Java Project 建立：不勾選 J2EE 面向，純 Java 專案模式
Builder 配置：`Properties → Builders → New → Ant Build`，指定 `build.xml`、Base Directory，停用預設 Java Builder (或保留並行)

build.xml 核心結構解析

1. 路徑屬性與 Classpath 定義


<property name="war.dir" value="dlist" />
<property name="src.dir" value="src" />
<property name="build.dir" value="classes" />
<property name="web.dir" value="web" />
<property name="lib.root" value="../common-lib" /> <!-- 外部共用庫根目錄 -->

<path id="master-classpath">
    <fileset dir="${lib.root}/struts">
        <include name="struts.jar" />
        <include name="struts-menu-2.3.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>
    <fileset dir="${lib.root}/spring-1.1.3">
        <include name="spring.jar" />
        <include name="aopalliance.jar" />
    </fileset>
    <pathelement path="${build.dir}" />
</path>

2. 清理任務


<target name="clean" description="Clean output directories">
    <delete dir="${build.dir}" />
    <delete dir="${war.dir}" />
    <delete dir="${dlist.dir}" />
</target>

3. 編譯與資源複製任務


<target name="build" description="Compile sources, copy resources, build JAR">
    <mkdir dir="${build.dir}" />
    
    <!-- 編譯 Java 原始碼 -->
    <javac srcdir="${src.dir}" destdir="${build.dir}" 
           source="1.3" target="1.3" debug="true" deprecation="false" optimize="false" failonerror="true">
        <classpath refid="master-classpath" />
    </javac>
    
    <!-- 複製配置檔至 classes (打入 JAR) -->
    <copy todir="${build.dir}" preservelastmodified="true">
        <fileset dir="${src.dir}">
            <include name="**/*.xml" />
            <include name="**/*.properties" />
        </fileset>
    </copy>
    
    <!-- Spring 資源檔特殊處理：複製至 WEB-INF/classes/conf (不打入 JAR) -->
    <copy todir="${web.dir}/WEB-INF/classes/conf" preservelastmodified="true">
        <fileset dir="${src.dir}/conf">
            <include name="springResources*.properties" />
        </fileset>
    </copy>
    
    <!-- 打包專案 JAR -->
    <mkdir dir="${web.dir}/WEB-INF/lib" />
    <jar jarfile="${web.dir}/WEB-INF/lib/${ant.project.name}.jar" compress="true">
        <fileset dir="${build.dir}"><include name="**" /></fileset>
    </jar>
    
    <!-- 複製執行期相依 JAR 至 WEB-INF/lib -->
    <copy todir="${web.dir}/WEB-INF/lib" preservelastmodified="true">
        <fileset dir="${lib.root}"><include name="log4j-1.2.8.jar" /></fileset>
        <fileset dir="${lib.root}/struts"><include name="struts*.jar" /></fileset>
        <fileset dir="${lib.root}/jakarta-commons"><include name="commons-*.jar" /></fileset>
        <fileset dir="${lib.root}/spring-1.1.3"><include name="spring.jar" /><include name="aopalliance.jar" /></fileset>
        <!-- 其他相依... -->
    </copy>
</target>

4. WAR 打包任務


<target name="warfile" description="Build WAR archive">
    <mkdir dir="${dlist.dir}" />
    <war warfile="${dlist.dir}/${ant.project.name}.war" 
         basedir="${web.dir}" 
         webxml="${web.dir}/WEB-INF/web.xml">
        <include name="*" />
        <include name="WEB-INF/*.*" />
        <exclude name="WEB-INF/web.xml" /> <!-- webxml 屬性已指定 -->
        <include name="WEB-INF/classes/**" />
        <include name="WEB-INF/lib/**" />
        <exclude name="**/.*" /> <!-- 排除隱藏檔 -->
    </war>
</target>

5. 文檔生成任務


<target name="javadoc" description="Generate API documentation">
    <mkdir dir="doc" />
    <javadoc destdir="doc" author="true" version="true" use="true" windowtitle="Project API">
        <packageset dir="${src.dir}" defaultexcludes="yes">
            <include name="com/app/**" />
        </packageset>
        <doctitle><![CDATA[<h1>Project API Documentation</h1>]]></doctitle>
        <bottom><![CDATA[<i>All Rights Reserved.</i>]]></bottom>
    </javadoc>
</target>

6. 主流程串聯


<target name="all" description="Full build: clean → compile → war → javadoc">
    <antcall target="clean" />
    <antcall target="build" />
    <antcall target="warfile" />
    <antcall target="javadoc" />
</target>

<project name="MyWebApp" default="all" basedir=".">
    <!-- 以上 targets 置於此處 -->
</project>

關鍵實戰經驗總結

課題	解決方案
配置檔打包位置	Struts/iBATIS/Spring XML 打入 JAR 正常；Spring `.properties` 資源檔需複製至 `WEB-INF/classes` 才能被 `ClassPathResource` 載入
web.xml 位置	預先置於 `web/WEB-INF/web.xml`，`war` 任務 `webxml` 屬性指定
TLD 檔案	預先置於 `web/WEB-INF/tld/` 或 `web/WEB-INF/`，隨 WAR 打包
相依管理	編譯期 Classpath (`master-classpath`) 與執行期 `WEB-INF/lib` 複製列表分離維護
跨 IDE 共用	Ant 腳本無 IDE 綁定，Eclipse/JBuilder/IntelliJ 皆可執行