ant copy 复制文件用法

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

ant copy 复制文件


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














1. 拷贝单个文件到指定目录下。
例：
将${basedir}/old/old.txt文件拷贝到${basedir}/new下


2. 拷贝一批文件到指定目录下
例：






这里fileset定义的是原文件的组成形式，子属性表示包括，子属性表示排除，很简单，通过他们组合实现多文件的筛选，当然我这个例子用得很傻。比如



拷贝appget目录和ibatis目录下除了.log文件以外的其它所有文件和子目录。


可以把简写成，includes可以理解成include的复数形式，包含多个文件时用逗号隔开，excludes也一样。


3. 拷贝一个目录到指定目录下
例：







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


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


若不使用任何属性，如


则会拷贝${basedir}/old下的所有文件和子目录。


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


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


4. 拷贝单个的文件：
〈copy tofile="old.txt" file="new.txt" /〉就这么简单就行了。
当然也可以写成



这里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时使用文件过滤的实例


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




















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


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


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