Ant 学习笔记(二)--ANT常用任务:Copy Tasks

ANT常用任务:Copy Tasks

注意:本节笔记中所使用的缩写/名词:

[project.basedir] :　表示ant构建文件build.xml中project元素basedir属性的值.此属性在上一节中已有说明,再次不在赘述.

源文件 : 指被复制的文件.

源目录 : 是与源文件相关的文件夹,具体的解释说不清, 可以在回复中附上各位的解释说明.

复制文件 : 指复制后产生的副本文件.

目标目录 : 是与复制文件相关的文件夹.类同与源目录.

文件集 :　对应于ant中的fileset名词.是指一组文件的集合.

============================

复制指定文件

<copy file="myFile.txt" tofile="myCopy.txt"/>

    运行结果说明:
        复制源文件([ project.basedir]/myFile.txt)到同目录下([ project.basedir]/), 并将复制文件命名为"myCopy.txt".
============================

复制指定文件到指定目录

<copy file="myFile.txt" todir="anydir/other/dir">

    运行结果说明:
        复制源文件([ project.basedir]/myFile.txt)到指定目录([ project.basedir]/anydir/other/dir)下,复制文件名同源文件名.
============================

复制源目录到指定目录

<copy todir="anydir/other/dir">
    <fileset dir="new/dir"/>
</copy>

    运行结果说明:
        将源目录([ project.basedir]/new/dir)下的内容复制到目标目录([ project.basedir]/anydir/other/dir)下.
============================

复制文件集到指定目录

<copy todir="otherdir/dir">
  <fileset dir="new">
    <exclude name="**/*.txt">
  </fileset>
</copy>
<copy todir="otherdir/dir">
  <fileset dir="new" excludes="**/*.txt"/>
</copy>

    运行结果说明:
        这里需要说一下fileset.fileset的属性excludes的值或者其包含的元素exclude的name属性的值都包含"*"号, 在这里"*"号是什么意思呢?
        "*"是我们常见的通配符, *.txt就代表了所有的.txt文件, 但单个*所代表的内容中是不能包含slash (/) (或者back-slash?)的。所以，如果是：

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

则表示include(包含) ${lib.dir}文件夹(不包括其子文件夹)下的所有.jar文件.
        两个星号**则可以代表包含slash (或者back-slash?)的任意内容，用在路径里面那就是recursive(递归)的意思了。所以：

<fileset dir="${lib.dir}" includes="**/*.jar"/>

表示的是include ${lib.dir}及其子文件夹下的所有.jar文件.
        include是包含的意思, exclude是不包含,除...之外的意思.
        现在来说下运行结果, 将源目录([ project.basedir]/new)下,包括其子目录在内的所有非.txt文件复制到目标目录([ project.basedir]/otherdir/dir)下.
============================

复制文件集到指定目录,并将被所有的文件名都添加.bak后缀

<copy todir="otherdir/dir">
  <fileset dir="new"/>
  <globmapper from="*" to="*.bak">
</copy>

    运行结果说明:
        将源目录([ project.basedir]/new)下的文件及子目录下的文件复制到目标目录(([ project.basedir]/otherdir/dir))下, 并且将所有复制的文件或者文件夹的名称的最末添加.bak.
        这里需要说一下, 操作结束后会存在一个名称被加上.bak的空文件夹. 同时还会存在一个没有添加.bak的文件夹, 该文件夹包含所有附加上.bak 的文件.
        [PS]我表述不明白, 大家最好自己测试一下, 看看结果, 就有了直观的印象了






============================

复制文件集到指定目录, 并将复制后得到的文件中的@TITLE@替换为Foo Bar

  <copy todir="otherdir/dir">
    <fileset dir="new"/>
    <filterset>
      <filter token="TITLE" value="Foo Bar"/>
    </filterset>
  </copy>

    运行结果说明:
        将源目录([ project.basedir]/new)下的文件及子目录下的文件复制到目标目录(([ project.basedir]/otherdir/dir))下, 并且将所有被复制的文件的内容中包含@TITLE@的部分替换为Foo Bar