一. 安装配置Ant:下载地址为http://jakarta.apache.org,假设解压Ant的目录为<ANT-HOME>,接下来需在操作系统中设置如下环境变量:
1. ANT_HOME:ant的安装目录;
2. JAVA_HOME:JDK的安装目录;
3. PATH:把%ANT_HOME%/bin目录添加到PATH变量中,以便从命令行下直接运行ant;
二.创建build.xml文件:
1. 每个工程都对应一个build.xml文件,这个文件包含了与这个工程有关的路径信息和任务;
2. 每个build.xml文件都包含一个project和至少一个target元素;
3. target元素中包含一个或多个任务元素,任务是一段可执行代码,ant提供了内置任务集,用户也可开发自己的任务元素;
4. 最常用的构建工程的ant内置任务描述有:
? property:设置name/value形式的属性;
? mkdir:创建目录;
? copy:拷贝文件或文件夹;
? delete:删除文件或文件夹;
? javac:编译Java源文件:
? war:为web应用打包;
? javadoc:生成JAVA文档;
? jar:打包文档;
? java:运行java类;
三.build.xml元素简介:
1. 根元素"project":<project name=''工程名称" default="工程默认的target元素(必须指定)" basedir="工程基路径(如果设置为'.'就表示工程基路径为build.xml文件所在的路径)">;
2. target元素:<target name="任务名称" depends="执行本target之前必须完成的target">;
3. property元素:<property name="属性名" value="属性值">;另:<property environment="env"/> <property name="servletpath" value="${env.CATALINA_HOME}/common/lib/servlet-api.jar"/>,以上代码设置了一个系统 环境属性env,通过它可以访问系统环境变量,${env.CATALINA_HOME}代表了CATALINA_HOME系统环境变量;
4. mkdir元素:<mkdir dir="指定需创建的目录">,如果路径内容以"/","\"或"c:\"之类开始,就表示绝对路径,否则表示相对路径,相对路径的基路径取决于project元素的basedir属性;
5. copy元素:<copy todir="指定把文件拷贝到哪个目录"><fileset dir="指定从哪个目录拷贝文件"><include name="指定需要拷贝哪些文件"/><exclude name="指定不需要拷贝哪些文件"/><!--</span-->fileset><!--</span-->copy>(对于<include name="WEB-INF/**">表示需要拷贝WEB-INF目录下所有的文件,子目录及子目录下的文件,如果是<include name="WEB-INF/*.*">表示只拷贝WEB-INF目录下所有的文件,不包含子目录及子目录下的文件);
6. javac元素:用来编译Java源程序,<javac srcdir="Java源程序存放的目录" destdir="生成的class文件存放的目录,目录结构与package语句一致" classpath="在编译时需引用的jar文件路径(多个文件路径间用':'号分隔)"><!--</span-->javac>;
7. war元素: <war warfile=”生成的war文件名” webxml=”web应用的web.xml文件”><lib dir=”web应用的lib目录”/><classes dir=”web应用的classes目录”/><fileset dir=”指定把该目录下的所有文件加入到包中”/><!--</span-->war>;
8. echo元素: 它的作用与Dos的echo命令相似,用于向控制台回显文本,<echo message=”文本内容”/>或<echo>文本内容<!--</span-->echo>;
9. jar元素: <jar jarfile=”打包的jar文件名”><fileset dir=”指定需打包的文件目录”/><!--</span-->jar>;
10. javadoc元素: <javadoc packagenames="${packages}" sourcepath="${build.src}" destdir="${build.javadocs}" author="true" version="true" use="true" splitindex="true" windowtitle="${Name} API" doctitle="${Name}"><classpath refid="classpath"/><!--</span-->javadoc>;
四.运行Ant:
1. 直接运行ant,如果不带任何参数,ant会在当前路径下搜索build.xml文件,如果找到,就运行project元素的default属性指定的target;
2. 带参数执行ant:ant [-buildfile build.xml文件路径 [target名称]];
五.使用习惯:
1. target一般分为:
1) usage: 打印本脚本的帮助信息(缺省);
2) init: 初始化信息,变量等;
3) build(or compile): 编译;
4) javadoc: 生成Java API文档;
5) jar: 将生成文件打包成Jar包;
6) war: 将生成文件打包成war包(web应用)
7) clean: 清除过程文件,目录;
8) all: 全部任务执行;
2. Ant在项目中使用时的一般目录结构:
+-dist //放置编译,打包后的最终文件(classes文件,jar包,war包)
+-src
+-package //放置java源文件
+-webroot //jsp源文件及相关配置文件
+-build //放置编译后的文件
+-lib //放置编译所需要的相关类文件(jar包)
+-doc //放置生成的API文档
注:以上部分内容引用自<<Tomcat与Java Web开发技术详解>>一书.