Replace2：解決多環境部署與開發調試的雙重難題

前言：Ant 內建 Replace 任務的局限

在 Java 專案建置過程中，Apache Ant 的內建 replace 任務常被用於多環境部署。其原理簡單：在配置檔（如 log4j.properties、hibernate.cfg.xml）中放入佔位符（例如 @@Log.FilePath@@），再透過屬性檔（testenv.properties、devlopenv.properties）提供不同環境的實際值，建置時自動替換。這確實解決了手動修改配置檔易出錯、繁瑣的問題。

痛點：開發階段的「佔位符地獄」

然而，這種方式帶來了開發階段的嚴重副作用。當配置檔滿是 @@JBDC.URL@@、@@JBDC.USER@@ 這類佔位符時，開發者在本地啟動應用、除錯、執行單元測試時，程式會因找不到真實資料庫連線、Web Service 端點而直接報錯。每次想跑一下程式，都得先手動把佔位符換回真實值，改完再換回去，極大地降低了開發效率。

Replace2 的設計理念：兼顧部署與開發

Replace2 正是為了解決這一矛盾而生的自定義 Ant Task。其核心創新在於保留原始配置檔的可執行性：配置檔中保留真實的開發環境值，並在上方以註釋標記佔位符對應關係。

運作範例

以 log4j.properties 為例：

# log4j.appender.Y.File = @@Log.FilePath@@
log4j.appender.Y.File = E:\temp\info.log

建置時，Replace2 讀取 env.properties 中的 Log.FilePath=/opt/xxx/data/logs/info.log，替換緊鄰註釋的下一行，產出：

# log4j.appender.Y.File = @@Log.FilePath@@
log4j.appender.Y.File = /opt/xxx/data/logs/info.log

如此，開發者本地直接用真實值跑程式；部署時自動切換為目標環境值，兩全其美。

使用方法

1. 定義 Task：<taskdef name="replace2" classname="com.xxx.ant.Replace2" classpath="${replace2.jar}"/>
2. 調用：<replace2 propertisfile="${basedir}/env.properties" token="##"> 內嵌多個 <filepath path="..."/> 指定目標檔案。