Ant 數據類型詳解：PatternSet、FileSet、Selector、FileList、Path、Regexp 核心用法

Ant 核心數據類型：構建腳本靈活文件集合與路徑管理

Ant 除 Property 外，提供豐富的**數據類型** 作為 Task 的參數，實現文件匹配、路徑構建、條件篩選等復雜邏輯。本文系統介紹六大核心數據類型定義與引用模式。

一、 定義與引用機制

• 數據類型可定義在 `` (全局) 或 `` (局部) 作用域。
• 通過 `` 定義，其他處用 `` 引用，實現複用。

二、 六大核心數據類型速查

三、 實戰示例

1. PatternSet 定義通用排除模式

<patternset id="meta.excludes">
  <exclude name="**/*.bak"/>
  <exclude name="**/CVS/"/>
  <exclude name="**/.svn/"/>
  <exclude name="**/.git/"/>
</patternset>

<!-- 在 FileSet 中引用 -->
<fileset dir="${src}" id="source.files">
  <patternset refid="meta.excludes"/>
</fileset>

2. FileSet 複雜匹配與選擇器組合

<fileset dir="${build}" id="recent.jars">
  <include name="**/*.jar"/>
  <!-- Selector: 只選最近 7 天修改、大小 > 100KB 的 jar -->
  <date datetime="01/01/2023 00:00 AM" when="after" pattern="MM/dd/yyyy hh:mm aa"/>
  <size value="100k" when="more"/>
  <!-- 邏輯組合：預設 AND，可用 , , ,  嵌套 -->
  <and>
    <date .../>
    <size .../>
  </and>
</fileset>

3. Path 構建編譯/運行類路徑

<path id="compile.classpath">
  <pathelement location="${lib}/servlet-api.jar"/>
  <pathelement path="${java.class.path}"/>
  <fileset dir="${lib}">
    <include name="**/*.jar"/>
  </fileset>
</path>

<javac srcdir="${src}" destdir="${build}" classpathref="compile.classpath"/>

4. FileList 精確控制打包文件順序/列表

<filelist dir="${doc}" files="readme.txt;license.txt;changelog.md" id="release.docs"/>
<zip destfile="${dist}/docs.zip" filelistref="release.docs"/>

四、 選擇器 邏輯組合進階

選擇器可嵌套 ``, ``, ``, `` (等價於 `not` + `and`)，構建複雜條件：

<fileset dir="${src}">
  <or>
    <and>
      <name name="**/*Test.java"/>      <!-- 單元測試文件 -->
      <date when="after" datetime="01/01/2023"/> <!-- 近期修改 -->
    </and>
    <contains text="TODO" casesensitive="false"/> <!-- 或包含 TODO -->
  </or>
</fileset>

五、 最佳實踐

1. 優先用 FileSet：掃描目錄、支持通配符、可組合 Selector，覆蓋 90% 場景。
2. 提取公共 PatternSet：排除規則 (`.git`, `target`, `*.log`) 定義一次全局引用。
3. Path 管理 Classpath：避免硬編碼路徑分隔符 (`;` vs `:`) 與順序問題。
4. FileList 用於精確列表：發布包、文檔打包等需精確控制文件與順序時。
5. Selector 替代自定義 Task：時間、大小、內容匹配無需寫 Java 代碼。