Ant datatype
Ant中，除了Property可以做为Task执行时使用的值以外，Ant也提供了很多的数据类型。
下面就对这些数据类型做简要的介绍：
PatternSet
PatternSet用于定义一个pattern集合，同时可以指定一个id属性，以供在其它地方引用它。Patterset可以定义在project下，也可以定义在target下。
使用patternset时，有两种方式：
·使用includes,includesfile,excludes,excludesfile属性
|
Attribute |
Description |
|
includes |
指定要包括的文件名的pattern |
|
includesfile |
一个包括的文件的名称 |
|
excludes |
指定要排除的文件名的pattern |
|
excludesfile |
一个要排除的文件名 |
多个pattern之间用以逗号或者空格作为分隔符。
·使用include,exclude|includesfile,excludesfile子元素
Include或者exclude元素有下列属性：
|
Attribute |
Description |
Required |
|
name |
the pattern to in/exclude. |
Yes |
|
if |
Only use this pattern if the named property is set. |
No |
|
unless |
Only use this pattern if the named property is not set. |
No |
|
<?xml version="1.0" encoding="UTF-8" ?> <project default="main"> <!--define a ptattern set with includes attribute--> <patternset id="java_files_pattern" includes="**/*.java,**/*.class"> </patternset> <!--define a ptattern set with include subelement--> <patternset id="java_files_pattern2"> <include name="**/*.java"/> <include name="**/*.class"/> </patternset> <target name="main"> <echo>java_files_pattern:</echo> <echo>${toString:java_files_pattern}</echo> <echo>java_files_pattern2</echo> <echo>${toString:java_files_pattern2}</echo> </target> </project> |
上面的代码段中使用了${toString:refid}，Ant中有些数据类型（例如PatternSet）是支持toString方法的，使用${toString:refid}可以执行refid对应的toString方法。
测试结果如下：
|
main: [echo] java_files_pattern: [echo] patternSet{ includes: [**/*.java, **/*.class] excludes: [] } [echo] java_files_pattern2 [echo] patternSet{ includes: [**/*.java, **/*.class] excludes: [] } BUILD SUCCESSFUL |
在实际的应用中，显式地使用PatternSet本身用的并不多见。因为FileSet隐式的包括了PatternSet，所以常见的用法都是在FileSet。另外所有隐含FileSet的数据类型，同样也等于隐含了PatternSet。
FileSet
大多数构建过程中，都会操作文件集合，包括编译、复制、删除、打包等操作。这类构建流程中，非常重要，因此Ant提供了一种FileSet的Datatype。
文件集是以一个单独的目录做为根目录的文件集合。默认情况下，由根目录指定的文件集合包含了整个目录树下的所有的文件，其中包括了所有子目录中的所有文件。
|
Attribute |
Description |
Required |
|
dir |
根目录 |
必须指定 两者之一 |
|
file |
指定单一文件 |
|
|
defaultexcludes |
参考patternset |
No |
|
includes |
参考patternset |
No |
|
includesfile |
参考patternset |
No |
|
excludes |
参考patternset |
No |
|
excludesfile |
参考patternset |
No |
|
casesensitive |
是否大小写敏感。默认是true |
No |
|
followsymlinks |
Shall symbolic links be followed? Defaults to true. See the note below. |
No |
|
erroronmissingdir |
Specify what happens if the base directory does not exist. If true a build error will happen, if false, the fileset will be ignored/empty. Defaults to true. Since Apache Ant 1.7.1 (default is true for backward compatibility reasons.) |
No |
在使用FileSet时，要么是只有一个文件，指定file属性即可。要么是多个文件，指定一个dir即可。
另外，可以在<fileset />中内嵌<patternset /> 和<slector />
下面是官方给出的例子：
|
使用<patternset />的子元素： <fileset dir="${server.src}" casesensitive="yes"> <include name="**/*.java"/> <exclude name="**/*Test*"/> </fileset> 使用内嵌<patternset/>： <fileset dir="${server.src}" casesensitive="yes">
<patternset id="non.test.sources"> <include name="**/*.java"/> <exclude name="**/*Test*"/> </patternset> </fileset> 使用selector： <fileset dir="${server.src}" casesensitive="yes">
<filename name="**/*.java"/> <not> <filename name="**/*Test*"/> </not> </fileset> |
Selector
Patterset 是根据文件名进行匹配的，有时你想要删除过期的文件或者向远程站点上传发生变化的文件。你想用什么办法删除文件而保留目录呢？selector可以对细化对文件的选择。
从上图也是可以看出selector分为两类：常用的选择器、选择器容器。
选择器容器中，可以有多个选择器。
常用选择器：
|
常用选择器容器：
|
有关selector的使用，可以参考官方文档：
http://ant.apache.org/manual/Types/selectors.html
FileList
FileList 是一个List，是一个有序集合。如果需要使用有序文件集合时，可以使用这个。
|
Attribute |
Description |
Required |
|
dir |
根目录 |
Yes |
|
files |
文件列表，使用空格或者逗号分隔 |
如果没有内嵌<file />， 就必须指定这个属性。 |
<filelist id="docfiles" dir="${doc.src}"
files="foo.xml bar.xml"/> <filelist id="docfiles" dir="${doc.src}">
<file name="foo.xml"/> <file name="bar.xml"/> </filelist> |
Path
Path用于指定路径，例如环境变量中的PATH、ClassPath。在定义path时，使用:或者;进行分隔。（备注：写build.xml时，可以使用:或者;。由Ant自动的根据操作系统转为相应的分隔符。）
<classpath> 与<path />的方法是一样的。<path />下可以有<pathelement />以及其它的资源集合（例如：fileset,filelist,dirset,path等）
<pathelement> 使用说明
Pathelement可以指定两种属性：
·location 用于指定一个文件或者目录。可以是相对路径，也可以是绝对路径。如果是相对路径，则是相对于project的basedir。
·path 由,或者;分隔的多个location。
<classpath> <pathelement path="${classpath}"/>
<pathelement location="lib/helper.jar"/> </classpath> |
<classpath> <pathelement path="${classpath}"/>
<fileset dir="lib"> <include name="**/*.jar"/> </fileset> <pathelement location="classes"/> <dirset dir="${build.dir}">
<include name="apps/**/classes"/> <exclude name="apps/**/*Test*"/> </dirset> <filelist refid="third-party_jars"/> </classpath> |
每个path,classpath也有2个属性：id,refid。
id用于被其它地方使用refid引用。
<project ... > <path id="project.class.path"> <pathelement location="lib/"/> <pathelement path="${java.class.path}/"/>
<pathelement path="${additional.path}"/>
</path> <target ... > <rmic ...> <classpath refid="project.class.path"/> </rmic> </target> <target ... > <javac ...> <classpath refid="project.class.path"/> </javac> </target> </project> |
Regexp
Regexp代表一个正则表达式，可以指定id属性，供其它地方（task或者selector等）使用。
|
Attribute |
Description |
Required |
|
pattern |
regular expression pattern |
Yes |