Ant build.xml中的各种变量定义方式 http://blog.csdn.net/hittata/article/details/4744653
build.properties的使用 https://ant.apache.org/manual/Tasks/property.html
条件表达式:
nt 条件判断 condition http://www.blogjava.net/fingki/archive/2008/05/21/201919.html
ANT中的条件判断 http://blog.sina.com.cn/s/blog_68ef18a90100jvbi.html
ant利器之-逻辑判断 http://lwj0212.iteye.com/blog/1779689
命令行和ant脚本的参数传递 http://www.blogjava.net/zhyiwww/archive/2011/09/02/357823.html
<property name="needSVN1" value="${needSVN}" /> <target name="test"> <echo message="${needSVN},${needSVN1}是window服务器" /> </target>
调用: ant test -DneedSVN=true
输出: [echo] true,true是window服务器
说明:调用的时候给参数赋值, 那么在property或者target标签都可以直接引用.
如何在ant脚本中获取svn版本号 http://blog.csdn.net/edychang/article/details/12781671
到 http://www.oopsconsultancy.com/software/xmltask/下载xmltask.jar,存放得到ant的lib里面
只是一个很简单的任务:获取当前working copy的top svn revision,在已经安装了xmltask( http://www.oopsconsultancy.com/software/xmltask/)的前提下,我可以只靠一小段Ant脚本便可以完成这个任务:
<project name="GetSVNHeadRevision"> <taskdef name="xmltask" classname="com.oopsconsultancy.xmltask.ant.XmlTask"/> <property name="workingCopy" location="." /> <target name="default"> <exec dir="${workingCopy}" executable="svn"> <arg line="up" /> </exec> <exec dir="${workingCopy}" executable="svn" output="svninfo.xml"> <arg line="info --xml ${workingCopy}" /> </exec> <xmltask source="svninfo.xml"> <copy path="/info/entry/@revision" property="svn.head.rev" /> </xmltask> </target> </project>
通过antcall执行后,top revision会被保存在"svn.head.rev"属性中。
build.xml 标签
1.<project>标签
(1) default表示默认的运行目标,这个属性是必须的。
(2) basedir表示项目的基准目录。
(3) name表示项目名。
(4) description表示项目的描述。
2.<target>标签
(1).name表示标明,这个属性是必须的。
(2).depends表示依赖的目标。
(3)if表示仅当属性设置时才执行。
(4)unless表示当属性没有设置时才执行。
(5)description表示项目的描述。
3.<mkdir>标签
该标签用于创建一个目录,它有一个属性dir用来指定所创建的目录名,其代码如下:
<mkdir dir=”${class.root}”/>
4.<jar>标签
该标签用来生成一个JAR文件,其属性如下。
(1) destfile表示JAR文件名。
(2) basedir表示被归档的文件名。
(3) includes表示别归档的文件模式。
(4) exchudes表示被排除的文件模式
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 表示制定是否显示详细信息,默认值不显示。
ant执行命令的详细参数
-buildfile<file>,-file<file>,-f<file> :要指定执行构件的的位置和名称。
-find<file>,-s<file>: 查找构件文件,并执行找到的构件文件。
-help,-p:显示ant的命令帮助信息。在命令行中显示ant的命令选项及简短的介绍,-h是简写。
-version:显示ant 的版本信息。
-diagnostics:显示ant项目的运行环境、依赖库等信息,为错误诊断和报告提供一些有用的帮助信息。
-quiet,-q: 隐藏ant执行的提示输出信息。命令行将不会输出具体的target的执行信息。
-verbose,-v: 显示ant执行的详细信息,包括操作系统和Java环境等信息。
-debug,-d:显示ant执行调试的信息、详细的log信息。
-lib<path>:指定一个类库所在的位置(jar文件位置),让ant工具可以使用这些类文件。path类型指定类库文件。
-logfile<file>,-l<file>:指定ant执行时日志输出文件,让日志输出到指定文件而不在命令行输出。
-D<property>=<value>:用于设定一些变量,这些变量可以在target中直接引用,或覆盖已设定的属性值
Ant系统属性
os.name: 操作系统的名称。
basedir: 项目引用的根路径。
ant.home: Ant工具的根目录位置。
ant.file: 构件文件的绝对路径。
ant.version: ant的版本信息。
ant.java.version: ant检测到的JVM版本。
ant.project.name: 当前执行的项目名称及信息。
java.version: Java的版本信息。
java.home: Java的根目录位置。
java.class.path: Java类库的文件的位置。
line.separator: 换行符.
user.home: 用户的home目录,在Linux和UNIX中经常甬道。
获取并格式化日期或时间
4.12 Tstamp Task:获取并格式化日期或时间
Tstamp任务的作用是设定当前日期和时间的格式,可在target中使用。默认时日期的格式为yyyyMMdd(例如:20060516)。默认的时间格式为hhmm(例如:12:00)。默认时Ant工具设定TODAY(今天)格式为MMMM dd yy(例如:May 05 06)。这些格式与Java的日期格式相同。
4.12.1 Tstamp Task的属性及功能
Tstamp 任务包含以下属性:
(1)property:用于定义一个属性名称,通过这个属性可以得到Tstamp格式化后的日期或时间。
(2)pattern:用于设定要格式化时间或日期的格式,与Java中的SimpleDateFormat类中的格式相同。
(3)timezone:用于指定格式化时的时区,与Java中的timezone类中定义的相同。
(4)unit:用于设定与当时时间相差的单位。可设为millisecond(毫秒)、second(秒)、minute(分钟)、hour(小时)、day(日)、week(周)、month(月)和year(年)。
(5)offset:用于设定与当前时间相差的值,单位由unit设定。
(6)locale:用于指定格式化的locale值(不同国家和语言有不同的值)。与Java中的Locale类指定的i18n国际化功能相同。用不同国家的日期格式。
4.12.2 通过Tstamp Task格式化日期和时间的例子
用Tstamp格式化日期的时间的例子如下:
<?xml version="1.0"?> <project name="timestamp" default="timestampTarget"> <!-- //定义不同的日期格式 --> <tstamp> <format property="TODAY_UK" pattern="d-MMMM-yyyy" locale="en"/> </tstamp> <tstamp> <format property="TODAY_CN" pattern="d-MMMM-yyyy" locale="zh"/> </tstamp> <tstamp> <format property="touch.time" pattern="MM/dd/yyyy hh:mm aa" offset="-5" unit="hour"/> </tstamp> <!-- //输出的日期格式定义 --> <target name="timestampTarget" > <echo message="${DSTAMP}"/> <echo message="${TODAY_UK}" /> <echo message="${TODAY_CN}" /> <echo message="${touch.time}" /> </target> </project>
保存文件为timestamp.xml,然后在命令行中运行ant –f timestamp.xml。
这个例子的作用是:
● 通过${DSTAMP}获取Ant默认的日期格式。结果为20060708。
● 设定日期格式为d-MMMM-yyyy且使用英文语言。结果为8-July-2006。
● 设定日期格式为d-MMMM-yyyy且使用中文语言。结果为8-七月-2006。
● 设定日期和时间格式为MM/dd/yyyy hh:mm aa,同时设定时间为当前时间减去5个小时。结果为07/08/2006 04:46 下午,执行时间21:46。
删除文件
(1)删除单个文件的实例:
<delete file="/lib/ant.jar"/>
这个例子的作用是删除lib目录下的ant.jar文件。
(2)删除目录的实例:
<delete dir="lib"/>
这个例子的作用是删除lib目录,包括这个目录的所有子目录及文件,可以通过include或exclude类型指定删除的部分文件,而不是目录下的所有文件。
(3)删除所有备份文件和空的目录的例子:
<delete includeEmptyDirs="true"> <fileset dir="." includes="**/*.bak"/> </delete>
Ant build.xml (模板)
<?xml version="1.0"?> <project name="your_porject_name" default="deploy-db"> <!-- properies --> <!-- 定义一些常量 --> <property file="build.properties" /> <property name="src.dir" value="${basedir}/src" /> <property name="report.dir" value="${basedir}/report" /> <property name="lib.dir" value="${basedir}/lib" /> <property name="dist.dir" value="${basedir}/dist" /> <property name="doc.dir" value="${basedir}/doc" /> <property name="test.dir" value="${basedir}/test" /> <property name="target.dir" value="${basedir}/target" /> <property name="classes.dir" value="WebRoot/WEB-INF/classes" /> <property name="target.classes.dir" value="${target.dir}/classes" /> <property name="target.testclasses.dir" value="${target.dir}/test-classes" /> <property name="webroot.dir" value="${basedir}/WebRoot" /> <property name="db.dir" value="${basedir}/db" /> <!-- 定义classpath --> <!-- 指明你所用到的jar包、class 文件存放的位置 --> <path id="master-classpath"> <fileset file="WebRoot/WEB-INF/lib/*.jar" /> <pathelement path="${webroot.dir}/WEB-INF/classes" /> </path> <!--清除所有输出目录--> <target name="clean" description="清空所有输出目录"> <echo message="清空所有输出目录"/> <delete dir="${target.classes.dir}" /> <delete dir="${target.testclasses.dir}" /> <delete dir="${target.dir}" /> <delete dir="${dist.dir}" /> <delete dir="${doc.dir}" /> </target> <!-- 初始化任务 --> <target name="init" depends="clean"> </target> <!-- 编译 --> <target name="compile" depends="init" description="编译所有的java类"> <echo message="编译所有的java类"/> <mkdir dir="${target.classes.dir}" /> <javac srcdir="${src.dir}" destdir="${target.classes.dir}" target="1.5"> <classpath refid="master-classpath" /> </javac> </target> <!-- 测试 --> <target name="test" depends="compile" description="进行单元测试"> <mkdir dir="${report.dir}"/> <junit printsummary="on" haltonfailure="false" failureproperty="tests.failed" showoutput="true"> <classpath refid="master-classpath" /> <formatter type="plain"/> <batchtest todir="${report.dir}"> <fileset dir="${classes.dir}"> <include name="**/*Test.*"/> </fileset> </batchtest> </junit> <fail if="tests.failed"> *********************************************************** **** 存在一个或多个错误 ,请检查错误 ...... **** *********************************************************** </fail> </target> <!--打包成jar --> <target name="pack" depends="compile" description="打jar包"> <echo message="生成your_project.jar"/> <mkdir dir="${dist.dir}" /> <jar destfile="${dist.dir}/your_porject.jar" basedir="${classes.dir}"> <exclude name="**/*Test.*" /> <exclude name="**/Test*.*" /> </jar> </target> <!-- WEB应用打成war包 --> <target name="war" depends="pack" description="打war包"> <echo message="生成your_project.war"/> <mkdir dir="${dist.dir}" /> <!-- jar命令 --> <!-- <jar destfile="${dist.dir}/your_project.war" basedir="${webroot.dir}"> <exclude name="**/*Test.*" /> <exclude name="**/Test*.*" /> </jar> --> <!-- war命令 --> <war warfile="${war.dest}/anttest.war" webxml="${buildwar.dest}/WEB-INF/web.xml"> <lib dir="${buildwar.dest}/WEB-INF/lib"/> <classes dir="${build.dest}"/> <fileset dir="${buildwar.dest}"/> </war> </target> <!-- 部署到tomcat webapps目录下--> <target name="deploy-war" depends="war" description="部署到tomcat webapps 目录下"> <echo message="部署your_project.war到tomcat的webapps下"/> <copy todir="${tomcat.dir}/webapps" overwrite="true" > <fileset dir="${dist.dir}"> <include name="your_project.war"/> </fileset> </copy> </target> <!-- 部署mysql数据库文件 --> <target name="deploy-db" depends="deploy-war" description="初始化mysql数据库"> <echo message="部署数据库文件到mysql的data目录下"/> <copy todir="${mysql.dir}/data" overwrite="ture"> <fileset dir="${db.dir}"> <include name="**/*.*" /> </fileset> </copy> </target> <!-- 输出api文档 --> <target name="doc" depends="compile" description="创建api文档"> <mkdir dir="${doc.dir}" /> <javadoc destdir="${doc.dir}" author="true" version="true" use="true" windowtitle="Your Project API"> <packageset dir="${src.dir}" defaultexcludes="yes"> <include name="com/pack/**" /> <!--所包含的包,这里需要根据实际进行改变 --> </packageset> <doctitle> <![CDATA[<h1>Your Project description</h1>]]></doctitle> <bottom> <![CDATA[<i>Your companny Name,Inc,All Rights Reserved.</i>]]></bottom> <tag name="todo" scope="all" description="To do:" /> </javadoc> </target> </project>
自动构建War包的Ant build.xml模板
<?xml version="1.0" encoding="UTF-8" ?> <project name="[*****]你的项目的名称" default="deploy" basedir="."> <property name="src.dir" value="src"/> <property name="webcontent.dir" value="[*****]WebContent目录,根据你自己的具体来写,比如这里就是WebRoot"/> <property name="lib.dir" value="WEB-INF/lib"/> <property name="web-inf.dir" value="${webcontent.dir}/WEB-INF"/> <property name="build.dir" value="build" /> <property name="dist.dir" value="dist"/> <property name="tomcat.home" value="[*****]Tomcat的webapps所在的路径"/> <path id="project.classpath"> <fileset dir="${webcontent.dir}/${lib.dir}"> <include name="*.jar"/> </fileset> </path> <target name="clean"> <delete dir="${build.dir}"></delete> <delete dir="${dist.dir}"></delete> <delete file="${tomcat.home}/${ant.project.name}.war"></delete> <delete dir="${tomcat.home}/${ant.project.name}"></delete> </target> <target name="init" depends="clean"> <mkdir dir="${build.dir}/classes"/> <mkdir dir="${dist.dir}"/> </target> <target name="compile" depends="init"> <javac srcdir="${src.dir}" destdir="${build.dir}/classes"> <compilerarg line="-encoding UTF-8"/> <classpath refid="project.classpath"></classpath> </javac> </target> <target name="publish" depends="compile"> <war destfile="${dist.dir}/${ant.project.name}.war" basedir="${webcontent.dir}" webxml="${web-inf.dir}/web.xml"> <classes dir="${build.dir}/classes"></classes> <lib dir="${webcontent.dir}/${lib.dir}"></lib> <fileset dir="WebContent"/> </war> </target> <target name="deploy" depends="publish"> <copy file="${dist.dir}/${ant.project.name}.war" todir="${tomcat.home}"></copy> </target> </project>