什么是ant(http://mmi.blogbus.com/s1019356/)
ANT是一个基于Java的自动化脚本引擎,脚本格式为XML。除了做Java编译相关任务外,ANT还可以通过插件实现很多应用的调用。
1)ANT的基本概念:
2)ANT的安装:解包,设置路径
3)ANT的使用:最好的学习只不过是一个简单实用的例子起步……
ANT的基本概念:Java的Makefile
当一个代码项目大了以后,每次重新编译,打包,测试等都会变得非常复杂而且重复,因此c语言中有make脚本来帮助这些工作的批量完成。在Java中应用是平台无关性的,当然不会用平台相关的make脚本来完成这些批处理任务了,ANT本身就是这样一个流程脚本引擎,用于自动化调用程序完成项目的编译,打包,测试等。除了基于JAVA是平台无关的外,脚本的格式是基于XML的,比make脚本来说还要好维护一些。
每个ant脚本(缺省叫build.xml)中设置了一系列任务(target):比如对于一个一般的项目可能需要有以下任务。
任务1:usage 打印本脚本的帮助信息(缺省)
任务2:clean <-- init 清空初始化环境
任务3:javadoc <-- build <-- init 生成JAVADOC
任务4:jar <-- build <-- init 生成JAR
任务5:all <-- jar + javadoc <-- build <-- init 完成以上所有任务:jar javadoc
而多个任务之间往往又包含了一定了依赖关系:比如把整个应用打包任务(jar)的这个依赖于编译任务(build),而编译任务又依赖于整个环境初始化任务(init)等。
注:我看到很多项目的ant脚本中的命名基本上都是一致的,比如:编译一般叫build或者compile;打包一般叫jar或war;生成文档一般命名为javadoc或javadocs;执行全部任务all。在每个任务的中,ANT会根据配置调用一些外部应用并配以相应参数执行。虽然ANT可调用的外部应用种类非常丰富,但其实最常用的就2,3个:比如javac javadoc jar等。
ANT的安装
解包后在系统可执行路径中加入指向ant的bin的路径就可以了,比如可以在GNU/Linux上把以下配置加入/etc/profile中:
export ANT_HOME=/home/ant
export JAVA_HOME=/usr/java/j2sdk1.4.1
export PATH=$PATH:$JAVA_HOME/bin:$ANT_HOME/bin
这样执行ant 后,如果不指定配置文件ant会缺省找build.xml这个配置文件,并根据配置文件执行任务,缺省的任务设置可以指向最常用的任务,比如:build,或指向打印帮助信息:usage,告诉用户有那些脚本选项可以使用。
ANT的使用
最好的学习过程就是看懂那些open source项目中的build.xml脚本,然后根据自己的需要简化成一个更简单的,ANT和APACHE上很多非常工程派的项目:简单易用,而且适应性非常强,因为这些项目的建立往往来源于开发人员日常最直接的需求。
ant使用简介
ant 是apache 工程的一个子工程,是一个基于java的build工具。ant类似于make工具,但没有传统的make工具的缺点。传统的make往往只能限制在某一平台上使用,ant本身用java类实现,要构建的工程的配置文件用xml格式描述,可以很方便实现多平台编译,非常适合build大型工程。
1.安装配置ant:
ant 可以从http://ant.apache.org下载,目前最新版本为1.5.2。下载完毕后直接解压缩,目录如下:
ant
+-- bin // contains launcher scripts
|
+-- lib // contains Ant jars plus necessary dependencies
|
+-- docs // contains documentation
| +-- ant2 // a brief description of ant2 requirements
| |
| +-- images // various logos for html documentation
| |
| +-- manual // Ant documentation (a must read )
|
+-- etc
需要设置的环境变量:
ANT_HOME:ant的安装目录
JAVA_HOME:jdk的安装目录
PATH:把%ANT_HOME%/bin目录加到path变量,以便于从命令行下直接运行ant
假定ant装在c:/ant jdk装d:/j2sdk1.4.0
则在命令行下执行以下命令:
set ANT_HOME=c:/ant
set JAVA_HOME=D:/j2sdk1.4.0
set PATH=%PATH%;c:/ant/bin
在win2000命令提示符下工作时,每次都必须进行上面的设置,退出命令提示符后,这些变量的值又会恢复成原来的样子。为了避免这些麻烦,可以在 控制面板/系统/高级/环境变量 中设置。
上述设置完成后,就可以使用ant了。
2.建立工程描述文件build.xml
用ant编译规模较大的工程非常方便,每个工程都对应一个build.xml文件,这个文件包含与这个工程有关的路径信息和任务。下面是一个build.xml的例子:
<project name="logon" basedir="." default="dist">
<property name="dist.name" value="struts_demo"/>
<property name="src" location="src"/>
<property name="build" location="WEB-INF/classes"/>
<property name="dist" location="D:/tomcat/webapps/dist"/>
<!-- Build working classpath -->
<path id="project.class.path">
<pathelement path ="WEB-INF/lib/struts.jar"/>
<pathelement path ="WEB-INF/classes"/>
<pathelement path ="${classpath}"/>
</path>
<target name="init">
<tstamp/>
<!-- Create the build directory structure used by compile -->
<delete dir="${dist}"/>
</target>
<target name="compile" depends="init">
<javac srcdir="${src}" destdir="${build}">
<classpath refid="project.class.path"/>
</javac>
</target>
<!-- Build binary distribution -->
<target name="dist" depends="compile"
description="Create binary distribution">
<mkdir dir="${dist}"/>
<war destfile="${dist}/${dist.name}.war"
webxml="WEB-INF/web.xml">
<lib dir="WEB-INF/lib"/>
<classes dir="WEB-INF/classes"/>
<fileset dir="${basedir}"/>
</war>
</target>
</project>
要构建的工程目录如下:
struts_demo
+--jsp
|
+--src
|
+--WEB-INF
| +--classes
| |
| +--lib
| |
| +--web.xml
|
+--build.xml
每个build.xml文件都包含一个project和至少一个target。target包含任务元素,任务是一段可执行代码,每个任务元素都有一个id属性,以便于在文件中引用。ant有内置任务集可供使用,如上面文件中用到的property、javac和war,分别完成设置属性、编译和打包任务。当然如果需要的话也可以写自己的任务。
build.xml的根元素是progject,它有三个属性name default basedir,其中default是必需的。name指定工程的名字,basedir表示工程的基路径,设置为"."表示build.xml所在的路径。default表示默认的target,运行ant时如果不指定target,则用default指定的target.
property任务用来设置属性,一个工程可以设置很多属性,属性有名字和值,属性设置后可以在后面引用。
<property name="dist.name" value="struts_demo"/>设置一个名字为dist.name的属性,其值为struts_demo,后面使用时用${dist.name}引用,表示字符串struts_demo.
<property name="src" location="src"/>设置一个名字为src的属性,它的值是一个路径,用location设置。如果location内容以/或/或D:/ C:/之类开始,表示绝对路径,否则表示相对路径,相对于project中设置的basedir.
使用path或classpath可以设置类的路径,后面引用时用id设置的值
构建工程最常用的ant内置任务:
mkdir: 创建目录,dir=要创建的目录
delete: 删除文件或文件夹 dir=要删除的文件或文件夹
javac: 编译java源文件,java源文件放在srcdir指定的文件夹中,生成的.class文件按照 package语句组织目录,存放在destdir指定的文件夹中。要注意源文件的目录组织要与package语句相一致
war: 为web应用程序打包,destfile指定打包后生成的文件名,webxml指定所用的web.xml文件。<fileset dir="${basedir}"/>将basedir目录下所有的文件也放在包中
上面的build.xml例子中,target中的属性depends表示在执行本target之前必须要做的target,
例如dist 的depends=compile,意思是在用dist打包之前必须先用compile编译。这样当执行dist时首先执行compile
3.运行ant:
使用ant.bat可以直接运行ant,如果不带任何参数,ant会在当前路径下搜索build.xml文件,如果找到,就运行project的default指定的target.也可以带参数来选择build.xml文件和要运行的target
对于上面的例子,假定build.xml所在的目录为D:/struts_demo/ ,则下面三种执行方式效果是一样的:
1. cd d:/struts_demo
ant
2. ant -buildfile d:/struts_demo/build.xml
3. ant -buildfile d:/struts_demo/build.xml dist
如果执行ant -buildfile d:/struts_demo/build.xml compile,则执行compile target
有关ant使用和build.xml文件内容,在ant的manual中有详细的描述。
使用 ANT 开发 Java 程序
常听大家讨论哪个 Java 开发工具比较好,JBuilder,Virtual Cafe ?
今天介绍一个简单易用的 Java 开发,编译,集成,测试工具:Jakarta Ant
他被称为 java 环境里的 make (make 在 C 程序开发里人人皆知)
Java 程序编辑器爱用啥用啥,我喜欢用 UltraEdit。
以 HelloWorld 为例介绍他的使用。
此示例可在此下载:
ftp://cinc.dns2go.com/pub/doc/code/ant/HelloWorld.zip
.下载 ant :(最新版 1.5)
http://jakarta.apache.org/builds/jakarta-ant/release/v1.5/bin/
windows 下请下载 zip 文件
unix 下请下载 tar.gz 文件
.安装 JDK:
安装到 c:/jdk,并确认能找到 c:/jdk/bin/java
.安装 ant:
把 ant 解压到本地硬盘 c:/ant,并确认能找到 c:/ant/bin/ant.bat
.设置环境变量:
JDK_HOME:c:/jdk
ANT_HOME:c:/ant
PATH:在原来的 PATH 开头加上 c:/ant/bin;c:/jdk/bin
注:
windows 下做操作:我的电脑 -> 属性 -> 高级 -> 环境变量 -> 用户变量
每次修改完环境变量,要重新打开 MS-DOS 窗口才能生效
.开始开发:
一个 ant 项目目录结构:
c:/HelloWorld :项目主目录
/src :源程序目录
/classes :编译后的 class 文件目录
/lib :开发项目所需要的类库目录,比如开发数据库时所需要的 jdbc lib(这次没用到)
/jar :打包好的 jar 程序目录(这次没用到)
/build.xml :项目配置文件
1.建立一个项目的主目录
mkdir c:/Helloworld
2.创建项目配置文件:
c:/HelloWorld/builder.xml
-----------------------------------------------------------------------------
<?xml version="1.0"?>
<project default="build" basedir=".">
<property name="appname" value="HelloWorld" />
<property name="base" value="." />
<property name="src" value="src" />
<property name="build" value="classes" />
<property name="myclasspath" value="${build}" />
<target name="build">
<mkdir dir="${build}" />
<javac classpath="${myclasspath}" srcdir="${src}" destdir="${build}">
<include name="**/*.java" />
</javac>
</target>
<target name="run" depends="build">
<exec executable="java">
<arg line=" -classpath ${myclasspath} HelloWorld" />
</exec>
</target>
<target name="clean">
<delete includeEmptyDirs="true">
<fileset dir="${build}" />
</delete>
</target>
</project>
-----------------------------------------------------------------------------
3.建立源代码目录,所有的 Java 程序放在里面
mkdir c:/HelloWorld/src
4.创建 HelloWorld.java
c:/HelloWorld/src/HelloWorld.java
-----------------------------------------------------------------------------
/**
* Demo class for run HelloWorld by ANT
*/
public class HelloWorld {
public static void main(String args[]){
System.out.println ("Hello World!");
}
} //EOC
-----------------------------------------------------------------------------
5.编译 HelloWorld
C:/HelloWorld>ant build
Buildfile: build.xml
build:
BUILD SUCCESSFUL
Total time: 2 seconds
说明:
调用 builder.xml 中的 target build
在 c:/HelloWorld/classes 里会出现 HelloWorld.class
此命令会把 src 目录下所有的 java 文件(包括子目录下的)都编译
6.运行 HelloWorld
C:/HelloWorld>ant run
Buildfile: build.xml
build:
run:
[exec] Hello World!
BUILD SUCCESSFUL
Total time: 2 seconds
调用 builder.xml 中的 target run
注意 target run 后的 depends="build",只有 build 成功后 run 才可以被调用
7.清除 class 文件:
C:/HelloWorld>ant clean
Buildfile: build.xml
clean:
[delete] Deleting 1 files from C:/Helloworld/classes
[delete] Deleted 1 directory from C:/Helloworld/classes
BUILD SUCCESSFUL
Total time: 2 seconds
使用 ANT 的好处:
1.相对于其他项目管理工具,只有一个文本配置文件 build.xml,配置简单
2.命令简单,一学就会,ant run, ant clean ...
3.安装简单,占用资源少,只要安装 Jdk, ANT 就可以运行
用 ANT 进行 Java 程序开发,已经成了 Java 界的一个共识。
在此基础上,可以建立更复杂的项目
在以后会继续介绍:
用 ANT 开发 数据库项目
用 ANT 开发 WEB 应用
用 ANT 和 CVS 开发多人项目,并进行项目版本管理。
推荐阅读:
Apache Ant 1.5 Manual
http://jakarta.apache.org/ant/manual/index.html
如果有时间,应该阅读,能发现许多 ant 的强大功能。