转载自：http://hi.baidu.com/laihua2006/blog/item/e54e113956f12932b9998f44.html

ant copy 复制文件

在用Ant部署时，出现：“警告： 编码 GBK 的不可映射字符”，网上找了一下，主要是编码兼容性的问题，需要个javac指定编码，于是在build.xml中加入以下说明即可：

<target name="compile" depends="prepare" description="编绎">
   <javac srcdir="${src.dir}" destdir="${build.classes.dir}" debug="on" deprecation="on" optimize="off" includes="**">
    <!--给编译器指定编码，防止出现："警告： 编码 GBK 的不可映射字符"-->
  <compilerarg line="-encoding UTF-8 "/>  
    <classpath refid="build.classpath" />
   </javac>
</target>

1. 拷贝单个文件到指定目录下。
例：<copy todir="${basedir}/new" file="${basedir}/old/old1.txt1"> 
将${basedir}/old/old.txt文件拷贝到${basedir}/new下

2. 拷贝一批文件到指定目录下
例：<copy todir="${basedir}/new">
            <fileset dir="${basedir}/old">
               <include name="old1.txt" />
               <include name="old2.txt" />
              <exclude name="old8.txt" />
          </fileset>
       </copy>
      这里fileset定义的是原文件的组成形式，<include/>子属性表示包括，<exclude/>子属性表示排除，很简单，通过他们组合实现多文件的筛选，当然我这个例子用得很傻。比如
                <include name="appgen/**"/>
                <include name="ibatis/**"/>
                <exclude name="**/*.log"/>
      拷贝appget目录和ibatis目录下除了.log文件以外的其它所有文件和子目录。

可以把<fileset/>简写成<fileset dir="${basedir}/old" includes="old1.txt,old2.txt" />，includes可以理解成include的复数形式，包含多个文件时用逗号隔开，excludes也一样。

3. 拷贝一个目录到指定目录下
例：<copy todir="${basedir}/new">
            <fileset dir="${basedir}/old">
              <include name="appgen" />
             <include name="appgen/" />
             <include name=appgen/**" />
             <include name="appgen/***" />
            </fileset>
        </copy>
       同样使用<fileset/>属性，name指定目录名，不过这里要分两种情况，用<include/>子属性和不用<include/>子属性.
      若使用<include/>， 又要分三种情况
          若是“appgen”，则只会拷贝名为appgen的空目录过去，它里面的文件和子目录则不会拷贝。
          若是“appgen/”，或“appgen/**”，则会把整个appgen目录拷贝过去，包括里面的文件和子目录。
          若是“appgen/*”，则只会把该目录和该目录下第一级子目录的所有东西拷贝过去，而不会拷贝第二级和第二级以下的。注：“appgen/*”这儿是一个*号，*号若大于两个，也跟一个*号是同样效果。比如“appgen/*”和“appgen/****”都只拷贝appgen目录下第一级子目录。

注：若appeng这个目录本身就是个空目录，无论怎么写，这个空目录都不会被拷贝。也就是说，copy操作不会产生创建空目录的作用，要想创建空目录，只有用mkdir。

若不使用任何<include>属性，如
           <fileset dir="${basedir}/old">
           </fileset>
       则会拷贝${basedir}/old下的所有文件和子目录。

注：使用<exclude/>排除目录时，目录名必须写成“appgen/”或“appgen/**”形式，否则不会生效。

以上是三种拷贝到目录的种类，注意如果计算机中没有todir指定的路径，ant将会自动创建这个路径。

4. 拷贝单个的文件： 
〈copy tofile="old.txt" file="new.txt" /〉就这么简单就行了。
当然也可以写成
<copy tofile="${basedir}/new/new.txt">
      <fileset dir="${basedir}/old" includes="old.txt" />
   </copy>
       这里includes就只能写一个文件，不能写上多个文件，因为不能将多个文件复制到一个文件中去，所以这样麻烦的写法是没有意义的。

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。

在执行Copy Task时使用文件过滤的实例

下面是一个复制文件的同时替换文件中的特殊符号的例子：

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

<fileset dir="src_dir"/>

<filterset>

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

</filterset>

</copy>

这个例子的作用是把src_dir目录下的所有文件复制到../backup/dir目录，并在所有文件中查找并替换@TITLE@为Foo Bar。当要进行新产品发布时通过需要替换文件中的版本信息和时间信息。

说明：在Ant工具中还提供了copydir和copyfile这两个特定的任务，分别用于对目录和文件进行复制。但自从有了Copy任务后，这两个任务已过期，不建议再使用，应该统一使用Copy任务。

小例：从工作空间复制到Tomcat 里面去

<?xml version="1.0" encoding="UTF-8"?>
<project name="" default="lch" basedir=".">
    <property name="db_file_dir" value="C:/Users/Administrator/workspace/gdagri/WebRoot/WEB-INF/classes/gznxt/database/"/>
    <property name="row_file_dir" value="C:/Users/Administrator/workspace/gdagri/WebRoot/WEB-INF/classes/gznxt/entity/"/>
    <property name="to_db_dir"  value="D:/tool/apache-tomcat-5.5.26/webapps/gdnyw/WEB-INF/classes/gznxt/database/"/>
    <property name="to_row_dir" value="D:/tool/apache-tomcat-5.5.26/webapps/gdnyw/WEB-INF/classes/gznxt/entity/"/>
    <!--  每次本地编译到服务器里面时，不要忘记重启服务器Tomcat  下面是农运通的  laefage -->
    <target name="lch_1" >
            <copy todir="${to_row_dir}">
                <fileset dir="${row_file_dir}">
                    <include name="TransportGoodsRow.class"/>
                    <include name="TransportCartRow.class"/>
                </fileset>
            </copy>
        </target>
    
    <target name="lch" >
        <copy todir="${to_db_dir}" overwrite="true">
            <fileset dir="${db_file_dir}">
                <include name="TransportCartDB.class"/>
                <include name="TransportGoodsDB.class"/>
            </fileset>
        </copy>
    </target>
    
</project>