首页 > 代码库 > 一个简单的ant应用

一个简单的ant应用

<pre name="code" class="html"><?xml version="1.0" encoding="UTF-8"?

> <project name="hd_services" default="war" basedir="."> <property name="tomcat.home" value="http://www.mamicode.com/E:/r/apache-tomcat-7" /> <property name="hd.src" value="http://www.mamicode.com/src" /> <property name="hd.classes" value="http://www.mamicode.com/build/classes" /> <property name="hd.build" value="http://www.mamicode.com/build" /> <property name="hd.lib" value="http://www.mamicode.com/WebContent/WEB-INF/lib" /> <target name="clean"> <delete dir="${hd.build}" /> </target> <path id="lib.path"> <fileset dir="${hd.lib}"> <include name="**/*.jar" /> </fileset> </path> <target name="compile" depends="clean"> <mkdir dir="${hd.classes}" /> <javac srcdir="src" destdir="${hd.classes}" includeantruntime="no" classpathref="http://www.mamicode.com/lib.path"> <exclude name="tests/**/*.java" /> <!--<include name="**/*.java" />--> </javac> <copy todir="${hd.classes}"> <fileset dir="src"> <include name="config/**/*.properties" /> <include name="config/**/*.xml" /> </fileset> </copy> </target> <target name="war" depends="compile"> <war destfile="${hd.build}/hd_services.war" webxml="WebContent/WEB-INF/web.xml"> <fileset dir="WebContent" includes="**/*.jsp" /> <lib dir="${hd.lib}" /> <classes dir="${hd.classes}" /> </war> </target> <target name="deploy" depends="war"> <copy todir="${tomcat.home}/webapps"> <fileset dir="${hd.build}"> <filename name="*.war"/> </fileset> </copy> </target> </project>




<?xml version="1.0" encoding="UTF-8"?>
<!-- 定义一些变量,就好比在java中定义一些变量,以备以下使用 -->

<!-- 所在项目的位置,。代表项目下,。

项目的子包下 --> <project name="helloworld" basedir="."> <!-- 定义一个属性变量 用作指定项目的原文件所在的文件夹 "${basedir} =basedir="."--> <property name="src.dir" value="http://www.mamicode.com/${basedir}/src"/> <!-- 环境变量 --> <property environment="env"/> <property name="jboss.home" value="http://www.mamicode.com/${env.JBOSS_HOME}"/> <property name="jboss.server.config" value="http://www.mamicode.com/default"/> <!-- 编译 class 存放的文件夹 --> <property name="build.dir" value="http://www.mamicode.com/${basedir}/build"/> <!-- 引入的jar包 --> <path id="build.classpath"> <fileset dir="${jboss.home}\client"> <include name="*.jar"/> </fileset> <!-- 把自已的 jar文件也引入 --> <pathelement location="${build.dir}"/> </path> <!-- 创建一个文件夹 --> <target name="prepare"> <delete dir="${build.dir}"/> <mkdir dir="${build.dir}"/> </target> <!-- 编译 --> <target name="compile" depends="prepare" description="编译"> <javac srcdir="${src.dir}" destdir="${build.dir}" includeantruntime="on"> <classpath refid="build.classpath"/> </javac> </target> <target name="ejbjar" depends="compile" description="创建ejb公布包"> <jar jarfile="${basedir}\${ant.project.name}.jar"> <fileset dir="${build.dir}"> <include name="**/*.class"/> </fileset> </jar> </target> <!-- 依懒于ejbjar 把编译好的class复制到jboss公布文件夹下--> <target name="deploy" depends="ejbjar" description="公布ejb"> <copy file="${basedir}\${ant.project.name}.jar" todir="${jboss.home}\server\${jboss.server.config}\deploy"/> </target> <target name="undeploy" description="御载ejb"> <delete file="${jboss.home}\server\${jboss.server.config}\deploy\${ant.project.name}.jar"/> </target> </project>



Ant的构建文件
当開始一个新的项目时,首先应该编写Ant构建文件。

构建文件定义了构建过程。并被团队开发 中每一个人使用。

Ant构建文件默认名为build.xml,也能够取其它的名字。

仅仅只是在执行的时候 把这个命名当作參数传给Ant。构建文件能够放在不论什么的位置。

一般做法是放在项目顶层文件夹中。

这样能够保持项目的简洁和清晰。以下是一个典型的项目层次结构。

(1) src存放文件。
(2) class存放编译后的文件。
(3) lib存放第三方JAR包。
(4) dist存放打包,公布以后的代码。

Ant构建文件是XML文件。每一个构建文件定义一个唯一的项目(Project元素)。每一个项目下能够定 义非常多目标(target元素),这些目标之间能够有依赖关系。当运行这类目标时。须要运行他们所 依赖的目标。

每一个目标中能够定义多个任务。目标中还定义了所要运行的任务序列。Ant在构建目标时必须调 用所定义的任务。任务定义了Ant实际运行的命令。Ant中的任务能够为3类。

(1) 核心任务。

核心任务是Ant自带的任务。

(2) 可选任务。

可选任务是来自第三方的任务,因此须要一个附加的JAR文件。

(3) 用户自己定义的任务。用户自己定义的任务是用户自己开发的任务。

4标签编辑

1.<project>标签
每一个构建文件相应一个项目。<project>标签时构建文件的根标签。它能够有多个内在属性。 就如代码中所看到的。其各个属性的含义分别例如以下。
(1) default表示默认的执行目标。即指定默认的target(即任务)。这个属性是必须的。

(2) basedir表示项目的基准文件夹。
(3) name表示项目名。
(4) description表示项目的描写叙述。

每个构建文件都相应于一个项目。可是大型项目常常包括大量的子项目,每个子项目都能够有
自己的构建文件。
2.<target>标签
一个项目标签下能够有一个或多个target标签。

一个target标签能够依赖其它的target标签。

例 如,有一个target用于编译程序,还有一个target用于生成可运行文件。在生成可运行文件之前必须先编译该文件,因此可运行文件的target依赖于编译程序的target。Target的全部属性例如以下。

(1).name表示标明,这个属性是必须的。
(2).depends表示依赖的目标。

(3)if表示仅当属性设置时才运行。

(4)unless表示当属性没有设置时才运行。
(5)description表示项目的描写叙述。
Ant的depends属性指定了target的运行顺序。Ant会按照depends属性中target出现顺序依次运行 每一个target。在运行之前。首先须要运行它所依赖的target。程序中的名为run的target的 depends属性compile,而名为compile的target的depends属性是prepare。所以这几个target执 行的顺序是prepare->compile->run。一个target仅仅能被运行一次。即使有多个target依赖于它。

假设没有if或unless属性target总 会被运行。

3.<mkdir>标签
该标签用于创建一个文件夹,它有一个属性dir用来指定所创建的文件夹名,其代码例如以下:
<mkdir dir=”${class.root}”/>
通过以上代码就创建了一个文件夹,这个文件夹已经被前面的property标签所指定。

4<jar>标签
该标签用来生成一个JAR文件。其属性例如以下。

(1) destfile表示JAR文件名称。

(2) basedir表示被归档的文件名称。
(3) includes表示被归档的文件模式。

(4) excludes表示被排除的文件模式。
5.<javac标签>
该标签用于编译一个或一组java文件,其属性例如以下。
(1).srcdir表示源程序的文件夹。
(2).destdir表示class文件的输出文件夹。
(3).include表示被编译的文件的模式。
(4).excludes表示被排除的文件的模式。

(5).classpath表示所使用的类路径。

(6).debug表示包括的调试信息。

(7).optimize表示是否使用优化。
(8).verbose 表示提供具体的输出信息。

(9).fileonerror表示当碰到错误就自己主动停止。

6.<java>标签
该标签用来运行编译生成的.class文件。其属性例如以下。
(1).classname 表示将运行的类名。
(2).jar表示包括该类的JAR文件名称。

(3).classpath所表示用到的类路径。
(4).fork表示在一个新的虚拟机中执行该类。
(5).failonerror表示当出现错误时自己主动停止。
(6).output 表示输出文件。
(7).append表示追加或者覆盖默认文件。

7.<delete>标签
该标签用于删除一个文件或一组文件,去属性例如以下。
(1)/file表示要删除的文件。
(2).dir表示要删除的文件夹。
(3).includeEmptyDirs 表示指定是否要删除空文件夹。默认值是删除。

(4).failonerror 表示指定当碰到错误是否停止,默认值是自己主动停止。
(5).verbose表示指定是否列出所删除的文件,默认值为不列出。
8.<copy>标签
该标签用于文件或文件集的拷贝,其属性例如以下。
(1).file 表示源文件。

(2).tofile 表示目标文件。

(3).todir 表示目标文件夹。
(4).overwrite 表示指定是否覆盖目标文件,默认值是不覆盖。

(5).includeEmptyDirs 表示制定是否拷贝空文件夹。默认值为拷贝。
(6).failonerror 表示指定如目标没有发现是否自己主动停止,默认值是停止。

(7).verbose 表示制定是否显示具体信息,默认值不显示。
9.<exec>运行文件
<execexecutable="${base.dir}/email.bat" >
</exec>

5数据类型编辑

在构建文件里为了标识文件或文件组,常常须要使用数据类型。数据类型包括在 org.apache.tool.ant.types包中。以下就简介构建文件里一些经常使用的数据类型。

1. argument 类型
由Ant构建文件调用的程序,能够通过<arg>元素向其传递命令行參数。如apply,exec和java任 务均可接受嵌套<arg>元素。能够为各自的过程调用指定參数。下面是<arg>的全部属性。
(1).values 是一个命令參数。假设參数种有空格,但又想将它作为单独一个值,则使用此属性 。
(2).file表示一个參数的文件名称。在构建文件里,此文件名称相对于当前的工作文件夹。
(3).line表示用空格分隔的多个參数列表。
(4).path表示路径。

2.ervironment 类型
由Ant构建文件调用的外部命令或程序。<env>元素制定了哪些环境变量要传递给正在运行的系 统命令,<env>元素能够接受下面属性。
(1).file表示环境变量值得文件名称。此文件名称要被转换位一个绝对路径。

(2).path表示环境变量的路径。Ant会将它转换为一个本地约定。
(3).value 表示环境变量的一个直接变量。

(4).key 表示环境变量名。
注意 file path 或value仅仅能取一个。

3.filelist类型
Filelist 是一个支持命名的文件列表的数据类型。包括在一个filelist类型中的文件不一定是
存在的文件。下面是其全部的属性。
(1).dir是用于计算绝对文件名称的文件夹。

(2).files 是用逗号分隔的文件名称列表。
(3).refid 是对某处定义的一个<filelist>的引用。
注意 dir 和files 都是必要的,除非指定了refid(这样的情况下,dir和files都不同意使用)。
4.fileset类型
Fileset 数据类型定义了一组文件,并通常表示为<fileset>元素。只是,很多ant任务构建成了 隐式的fileset,这说明他们支持全部的fileset属性和嵌套元素。下面为fileset 的属性列表。
(1).dir表示fileset 的基文件夹。
(2).casesensitive的值假设为false,那么匹配文件名称时。fileset不是区分大写和小写的。其默认 值为true.
(3).defaultexcludes 用来确定是否使用默认的排除模式。默觉得true。
(4).excludes 是用逗号分隔的须要派出的文件模式列表。
(5).excludesfile 表示每行包括一个排除模式的文件的文件名称。
(6).includes 是用逗号分隔的。须要包括的文件模式列表。
(7).includesfile 表示每行包括一个包括模式的文件名称。
5.patternset 类型
Fileset 是对文件的分组,而patternset是对模式的分组,他们是紧密相关的概念。

<patternset>支持4个属性:includesexcludex includexfile 和excludesfile,与fileset相 同。

Patternset 还同意下面嵌套元素:include,exclude,includefile 和excludesfile.

6.filterset 类型
Filterset定义了一组过滤器,这些过滤器将在文件移动或复制时完毕文件的文本替换。
主要属性例如以下:
(1).begintoken 表示嵌套过滤器所搜索的记号,这是标识其開始的字符串。
(2).endtoken表示嵌套过滤器所搜索的记号这是标识其结束的字符串。

(3).id是过滤器的唯一标志符。
(4).refid是对构建文件里某处定义一个过滤器的引用。
7.Path类型
Path元素用来表示一个类路径,只是它还能够用于表示其它的路径。在用作揖个属性时。路经中 的各项用分号或冒号隔开。在构建的时候,此分隔符将取代当前平台中全部的路径分隔符,其拥 有的属性例如以下。
(1).location 表示一个文件或文件夹。Ant在内部将此扩展为一个绝对路径。

(2).refid 是对当前构建文件里某处定义的一个path的引用。
(3).path表示一个文件或路径名列表。

8.mapper类型
Mapper类型定义了一组输入文件和一组输出文件间的关系,其属性例如以下。

(1).classname 表示实现mapper类的类名。当内置mapper不满足要求时,用于创建定制mapper.
(2).classpath表示查找一个定制mapper时所用的类型路径。
(3).classpathref是对某处定义的一个类路径的引用。
(4).from属性的含义取决于所用的mapper.
(5).to属性的含义取决于所用的mapper.
(6).type属性的取值为identity,flattenglob merge regexp 当中之中的一个,它定义了要是用的
内置mapper的类型。

一个简单的ant应用