如何编写适配不同部署环境的ANT构建脚本

这是一种简洁可靠的实现方式，利用Ant的**过滤（Filtering）**功能为每个环境生成专属的dbUser.properties，再打包成对应环境的WAR文件。以下是具体步骤和代码：

步骤1：准备模板文件 #

首先创建一个dbUser.template模板文件，用占位符代替具体的用户名和密码：

User=@DB_USER@
Pass=@DB_PASS@

步骤2：编写Build.xml构建文件 #

这个构建文件会加载原始的多环境配置，为每个目标环境设置专属属性，通过模板生成干净的配置文件，最后打包成带环境标识的WAR：

<project name="EnvSpecificWar" default="dev" basedir=".">
    <!-- 加载原始的多环境数据库配置文件 -->
    <property file="dbUser.properties"/>

    <!-- 定义基础路径属性（根据你的项目结构调整） -->
    <property name="webapp.src.dir" value="src/main/webapp"/> <!-- Web应用源码目录 -->
    <property name="build.dir" value="build"/> <!-- 临时构建目录 -->
    <property name="dist.dir" value="dist"/> <!-- WAR文件输出目录 -->

    <!-- 清理历史构建产物 -->
    <target name="clean">
        <delete dir="${build.dir}"/>
        <delete dir="${dist.dir}"/>
    </target>

    <!-- Dev环境构建目标 -->
    <target name="dev" depends="clean">
        <property name="env.name" value="dev"/>
        <property name="db.user" value="${User_Dev}"/>
        <property name="db.pass" value="${Pass_Dev}"/>
        <antcall target="package-war"/>
    </target>

    <!-- QA环境构建目标 -->
    <target name="qa" depends="clean">
        <property name="env.name" value="qa"/>
        <property name="db.user" value="${User_Qa}"/>
        <property name="db.pass" value="${Pass_Qa}"/>
        <antcall target="package-war"/>
    </target>

    <!-- Prod环境构建目标 -->
    <target name="prod" depends="clean">
        <property name="env.name" value="prod"/>
        <property name="db.user" value="${User_Prod}"/>
        <property name="db.pass" value="${Pass_Prod}"/>
        <antcall target="package-war"/>
    </target>

    <!-- 通用WAR打包逻辑 -->
    <target name="package-war">
        <!-- 创建构建目录结构 -->
        <mkdir dir="${build.dir}/WEB-INF"/>

        <!-- 复制Web应用文件到构建目录（排除原始多环境配置，避免泄露） -->
        <copy todir="${build.dir}">
            <fileset dir="${webapp.src.dir}">
                <exclude name="WEB-INF/dbUser.properties"/>
            </fileset>
        </copy>

        <!-- 生成当前环境专属的dbUser.properties -->
        <copy todir="${build.dir}/WEB-INF" filtering="true">
            <fileset file="dbUser.template"/>
            <filterset>
                <filter token="DB_USER" value="${db.user}"/>
                <filter token="DB_PASS" value="${db.pass}"/>
            </filterset>
            <mapper type="glob" from="dbUser.template" to="dbUser.properties"/>
        </copy>

        <!-- 打包成带环境标识的WAR文件 -->
        <war destfile="${dist.dir}/myapp-${env.name}.war" webxml="${build.dir}/WEB-INF/web.xml">
            <fileset dir="${build.dir}"/>
        </war>
    </target>
</project>

步骤3：执行构建 #

在命令行中运行对应环境的构建命令即可：

• 构建Dev环境WAR：ant dev
• 构建QA环境WAR：ant qa
• 构建Prod环境WAR：ant prod

生成的WAR文件会存放在dist目录下，命名格式为myapp-{env}.war（例如myapp-dev.war），其中只包含当前环境的数据库账号密码。

关键细节说明 #

1. 过滤功能：通过filtering="true"开启属性替换，将模板中的占位符替换为对应环境的实际值，确保每个WAR只包含当前环境的配置。
2. 安全防护：复制Web应用文件时排除了原始的多环境配置文件，避免敏感的生产环境密码被打包到测试环境的WAR中。
3. 代码复用：通用打包逻辑集中在package-war目标，各个环境目标只需设置专属属性后调用该目标，减少重复代码。

内容的提问来源于stack exchange，提问作者Adi Mukherjee