ant copy 复制文件用法

转载自：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>