ant copy

ant copy 复制文件

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

1. 拷贝单个文件到指定目录下。
   例：
   将{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 里面去