4.5 Copy Task：對檔案和目錄進行復制

Copy 任務把一個或多個檔案複製到指定的目錄下。但要注意的是，如果目標目錄下具有同名的檔案，那麼只有當原始檔相對於目標檔案更新時，Ant工具才會複製這個檔案。在Copy任務中可以使用FileSet型別來定義檔案集合。

4.5.1 Copy Task的屬性及功能

Copy 任務具有以下屬性：

（1）file：用於指定要複製的原始檔。

（2）preservelastmodified：作用是使得複製後的檔案與原始檔的最後修改時間相同。預設為false。

（3）tofile：用於指定要複製到的檔案。

（4）todir：用於指定要複製到的目標目錄。todir和tofile只能使用其中一個屬性。

（5）overwrite：用於指定是否需要覆蓋目錄和檔案，不管檔案是否比原始檔新，都會覆蓋。預設為false。

（6）filtering：用於指定在複製時是否使用構件檔案的全域性過濾器對檔案進行過濾。預設為false。

（7）flatten：用於指定是否需要複製目錄，如果為true代表把所有的檔案複製到todir屬性設定的目錄下。預設為false，複製目錄。

（8）includeEmptyDirs：用於指定是否複製空目錄。預設為true。

（9）failonerror：用於指定當遇到錯誤時是否停止執行。預設為true。

（10）verbose：用於指定當複製檔案時是否記錄日誌資訊。

（11）encoding：用於設定複製檔案時的編碼或檔案過濾器使用的編碼方式。預設時使用Java虛擬機器的編碼方式。

（12）outputencoding：指定寫檔案時的編碼方式。預設時使用Java虛擬機器的編碼方式。

（13）enablemultiplemappings：用於設定是否允許多個對映。預設為false。

（14）granularity：用於指定一個檔案修改時間的毫秒資料的允許誤差。因為不是所有的檔案系統的修改時間都是精確到毫秒數。預設時為0，如果為DOS系統則為2。

4.5.2 通過Copy Task實現檔案和目錄複製功能例項

不管是對程式進行打包還是一般的檔案操作，基本上都離不開復制功能。通過Ant工具的Copy任務可以讓程式在Windows和Linux/UNIX下對檔案和目錄進行復制操作。例如：

（1）對單個檔案進行復制：

<copy file="myfile.txt" tofile="mycopy.txt"/>

這個例子的作用是在當前目錄複製myfile.txt，並把複製的檔案命名為mycopy.txt。當需要把檔案複製到別外的目錄時可以這樣編寫：

<copy file="myfile.txt" todir="../some/other/dir"/>

這個例子的作用是把檔案複製到與當前目錄同級的some目錄的/other/dir子目錄下。這裡“..”代表相對路徑（當前目錄的上一級目錄）。

（2）對檔案目錄進行復制：

<copy todir="../new/dir">

    <fileset dir="src_dir"/>

</copy>

這個例子的作用是把src_dir目錄複製到../new/dir目錄下。有時對檔案進行復制時需要對檔案進行備份。下面舉一個複製檔案時對檔案進行備份的例子。

<copy todir="../backup/dir">

<fileset dir="src_dir">

    <exclude name="**/*.java"/>

   </fileset>

<globmapper from="*" to="*.bak"/>

</copy>

這個例子的作用是把src_dir目錄及其子目錄下所有非Java檔案複製到../backup/dir目錄下，並重命名為bak檔案，以作備份。

4.5.3 在執行Copy Task時使用檔案過濾的例項

下面是一個複製檔案的同時替換檔案中的特殊符號的例子：

<copy todir="../backup/dir">

    <fileset dir="src_dir"/>

    <filterset>

      <filter token="TITLE" value="Foo Bar"/>

    </filterset>

</copy>

這個例子的作用是把src_dir目錄下的所有檔案複製到../backup/dir目錄，並在所有檔案中查詢並替換@[email protected]為Foo Bar。當要進行新產品釋出時通過需要替換檔案中的版本資訊和時間資訊。

說明：在Ant工具中還提供了copydir和copyfile這兩個特定的任務，分別用於對目錄和檔案進行復制。但自從有了Copy任務後，這兩個任務已過期，不建議再使用，應該統一使用Copy任務。

4.6 Delete Task：對檔案和目錄進行刪除

Delete 任務可用於刪除一個或多個檔案，或刪除一個或多個目錄和目錄下的檔案。預設時不會刪除空目錄，要刪除空目錄可以設定includeEmptyDirs屬性為true。在Delete任務中可以使用FileSet和DirSet型別。

4.6.1 Delete Task的屬性及功能

Delete任務包括以下屬性：

（1）file：用於指定要刪除的檔案的名稱，可以為相對路徑或絕對路徑。

（2）dir：指定一個將要被刪除的根目錄。這個目錄下的子目錄及檔案將可能被刪除。dir屬性和file屬性兩者必須指定其一。

（3）verbose：作用是指定是否在命令列中輸出被刪除的檔案的名稱。預設為false。

（4）quiet：作用是指定當要被刪除的檔案或目錄不存在時是否不顯示提示資訊。預設為false，代表要顯示提示資訊。

（5）failonerror：用於指定當出現錯誤時是否停止執行命令。

（6）includeemptydirs：表明當使用FileSet型別時是否刪除空的目錄。

（7）includes：用於指定將要刪除的檔案或目錄的模式。可用逗號或空格符進行分隔。

（8）includesfile：用於指定要刪除的檔案的模式。已不建議使用。

（9）excludes：用於指定一個或多個檔案模式或目錄模式。這些符合條件的檔案和目錄將不被刪除。

（10）excludesfile：用於指定將不被刪除的檔案模式，已不建議使用。

（11）defaultexcludes：用於指定是否使用Ant預設的default excludes模式，已不建議使用。

（12）deleteonexit：用於指定是否採用Java File類中的deleteOnExit()方法進行判斷，如果使用這個方法，那麼僅當存在檔案時才進行刪除，預設取值為false。

4.6.2 在執行Delete Task時使用檔案過濾的例項

（1）刪除單個檔案的例項：

<delete file="/lib/ant.jar"/>

這個例子的作用是刪除lib目錄下的ant.jar檔案。

（2）刪除目錄的例項：

<delete dir="lib"/>

這個例子的作用是刪除lib目錄，包括這個目錄的所有子目錄及檔案，可以通過include或exclude型別指定刪除的部分檔案，而不是目錄下的所有檔案。

（3）刪除所有備份檔案和空的目錄的例子：

<delete includeEmptyDirs="true">

    <fileset dir="." includes="**/*.bak"/>

</delete>

這個例子的作用是刪除當前目錄以及其子目錄下的所有.bak檔案，同時也刪除所有空的目錄。