此任務(wù)用于將文件或資源復(fù)制到新位置,它僅在源文件比目標(biāo)文件更新時才復(fù)制。也可以使用overwrite
屬性顯式覆蓋它。
todir
屬性用于設(shè)置目標(biāo)路徑。 此任務(wù)使用下面給出的各種屬性。
屬性 | 描述 | 必需 |
---|---|---|
file |
要復(fù)制的文件 | 是 |
preservelastmodified |
保留上次修改的名稱 | 否 |
tofile |
要復(fù)制到目標(biāo)文件的文件 | 如果還指定了file 屬性,則只允許使用todir 。 |
todir |
目標(biāo)目錄名稱 | 如果還指定了file 屬性,則只允許使用todir 。 |
overwrite |
即使目標(biāo)文件較新,也會覆蓋現(xiàn)有文件 | 否 |
force |
覆蓋只讀目標(biāo)文件 | 否 |
filtering |
在復(fù)制過程中過濾 | 否 |
flatten |
通過忽略源文件的目錄結(jié)構(gòu)來復(fù)制文件 | 否 |
includeEmptyDirs |
復(fù)制空目錄 | 否 |
failonerror |
如果復(fù)制失敗,則顯示此錯誤消息。 | 否 |
quiet |
如果為true 且failonerror 為false ,則不記錄警告消息。 |
否 |
verbose |
它記錄正在復(fù)制的文件 | 否 |
encoding |
用于復(fù)制文件的編碼 | 否 |
outputencoding |
顯示要使用的編碼 | 否 |
下面來看一個例子,在這個示例中將數(shù)據(jù)從一個文件復(fù)制到另一個文件。 請參閱下面的示例。
復(fù)制單個文件
文件:build.xml
<project name = "java-ant project" default = "copy-file">
<target name="copy-file">
<copy file = "abc.txt" tofile = "xyz.txt"></copy>
</target>
</project>
將文件復(fù)制到目錄
<project name = "java-ant project" default = "copy-file">
<target name="copy-file">
<copy file="abc.txt" todir="../someother/dir"/>
</target>
</project>
將目錄復(fù)制到另一個目錄
<project name = "java-ant project" default = "copy-file">
<target name="copy-file">
<copy todir="../new/dir"><fileset dir="src_dir"/></copy>
</target>
</project>