ant是apache提供给java开发人员的构建工具，它可以在windows os和unix os下运行，它不仅开放源码并且还是一个非常好用的工具。我强烈建议在进行javabean、ejb等开发时安装，不建议安装make、makefile等建立在shell思想上的构建工具。
下载ant
官方网址: http://jakarta.apache.org/ant/
下载url: http://jakarta.apache.org/builds/jakarta-ant/release/
安装ant
设置ant_home系统变量和path系统变量
? windows
假如ant安装目录为c:ant，按下面方法设置
set ant_home=c:ant
set java_home=c:jdk1.3
set path=%path%;%ant_home%in
? unix
假如ant安装目录为/usr/local/ant，按下面方法设置
export ant_home=/usr/local/ant
export java_home=/usr/local/jdk1.3
export path=${path}:${ant_home}/bin
|
运行ant
前面说ant"是一个非常好用的工具"，就是因为运行它很简单，只要在命令行输入"ant"，ant就运行了。我以构建序列发生器sequencegenerator进行示例，
在控制台显示的构建信息：查看详细内容。
控制台快照，见下图：
ant的命令行参数
ant也可以通过命令行参数 -buildfile
来指定其他目标文件，其中，是你要采用的目标文件名。ant还有很多命令行可选参数，如下所示：
命令行可选参数摘要：
ant [options] [target [target2 [target3] ...]]
options:
-help print this message
-projecthelp print project help information
-version print the version information and exit
-quiet be extra quiet
-verbose be extra verbose
-debug print debugging information
-emacs produce logging information without adornments
-logfile file use given file for log output
-logger classname the class that is to perform logging
-listener classname add an instance of class as a project listener
-buildfile file use specified buildfile
-find file search for buildfile towards the root of the filesystem and
use the first one found
-dproperty=value set property to value
|
编写build.xml
ant的buildfile是用xml写的。每个buildfile含有一个project。
buildfile中每个任务元素可以有一个id属性，可以用这个id值引用指定的任务。这个值必须是唯一的。
下面是ant中常用的元素和任务：
常用的元素有"project"、"target"、"path"、"property"等。
常用的任务有"ant"、"mkdir"、"delete"、"copy"、"javac"、"jar"、"javadoc"、"echo"等。
（注：它们的详细用法，我不再详述，请参阅下载ant时ant中自带的用户手册。）
我以下面的build_for_ejb_templet.xml为示例，讲解ant中常用的元素和任务。
约定：
1. 每行代码的前部分为"数字"+"."，数字表示在xml文件中的行号
2. "…"表示这里有很多代码，未列出
build_for_ejb_templet.xml任务的分为以下几大部分
i. 开始
ii. 初始化
iii. 定义classpath
iv. 为编译作准备
v. 编译ejb部分
vi. 编译web部分
vii. 编译j2ee application
viii. 部署application
ix. 创建组件的api
x. 确定build的目标
build_for_ejb_templet.xml的讲解
开始
<?xml version="1.0" encoding="utf-8"?>
讲解：encoding="utf-8"表示xml文件采用utf-8编码格式，如果要使用gbk编码，
需定义为encodeing="gbk"。
3. <!--
4. build file for 'componentname'
5. creation date : $date: yyyy-m-d $
6. updated date : $date: yyyy-m-d $
7. author: developername
8. copyright 2002 companyname, inc. all rights reserved.
9. -->
讲解：此部分为文件内容的简介，包括文件名称、创建日期、最后修改日期、创建文件的作者、版权。
componentname 表示 文件名称
yyyy-m-dd 表示 创建日期、最后修改日期的格式，如2002-5-1
developername 表示 创建文件的作者
companyname 表示 公司名称或url
11. <project name="componentname" default="core" basedir=".">
…
254. </project>
讲解：此部分定义了一个名称为componentname的项目元素，缺省的任务为"core"任务，
根目录为当前目录。componentname表示组件的名称，这里指ejb的名称。
|
初始化
17. <target name="init">
…
63. </target>
讲解：此部分用于初始化所有的变量
18. <property file="../../build.properties" />
讲解：导入项目根目录下build.properties中的全局变量，开发人员也可以在此文件中重新定义全局变量。
19. <property name="jboss.lib" value="${jboss.home}/lib" />
20. <property name="jboss.client" value="${jboss.home}/client" />
21. <property name="jboss.deploy"
value="${jboss.home}/server/${jboss.configuration}/deploy" />
…
27. <property name="jboss.dir" value="${jboss.home}" />
…
41. <property name="deploy.ormi" value=""/>
42. <property name="deploy.username" value=""/>
43. <property name="deploy.password" value=""/>
讲解：定义和jboss application server有关的变量，包括lib目录、client目录、
deploy目录和j2ee application部署要用到的一些变量。
22. <property name="name" value="componentname" />
讲解：定义组件的名称
23. <property name="src.dir" value="${basedir}/src" />
讲解：定义源代码目录路径
24. <property name="etc.dir" value="${basedir}/etc" />
讲解：定义资源目录路径
25. <property name="lib.dir" value="${basedir}/lib" />
讲解：定义库目录路径
26. <property name="build.dir" value="${basedir}/build" />
讲解：定义build目录路径
28. <property name="src.main.dir" value="${src.dir}/main"/>
讲解：定义源代码的主目录路径
29. <property name="src.ejb.dir" value="${src.main.dir}/ejb"/>
讲解：定义存放ejb的源代码目录路径
30. <property name="src.javabean.dir" value="${src.main.dir}/javabean"/>
讲解：定义存放javabean的源代码目录路径
31. <property name="src.servlet.dir" value="${src.main.dir}/servlet"/>
讲解：定义存放servlet的源代码目录路径
32. <property name="src.web.dir" value="${src.main.dir}/web"/>
讲解：定义存放web部分文件（包括jsp程序、html文件、图片、css文件、js脚本等）的目录路径
33. <property name="javadoc.dir" value="${lib.dir}/docs/api" />
讲解：定义存放组件api的开发文件目录路径
34. <property name="ejb-classes.dest" value="${lib.dir}/ejb" />
讲解：定义存放ejb的编译代码目录路径
35. <property name="javabean-classes.dest" value="${lib.dir}/javabean" />
讲解：定义存放javabean的编译代码目录路径
36. <property name="web-classes.dest" value="${lib.dir}/web/web-inf/classes" />
讲解：定义web目录的类目录路径
37. <property name="web-lib.dest" value="${lib.dir}/web/web-inf/lib" />
讲解：定义web目录的库目录名称
38. <property name="pkg-dist.name" value="${name}-pkg" />
讲解：定义压缩文档的名称
45. <property name="projectname.components.home" value="../../components" />
讲解：定义项目的组件目录路径
47. <!-- define componentname component -->
讲解：这段为注释，说明以下是定义当前组件的变量
48. <property name="projectname.componentname.name" value="componentname"/>
讲解：定义当前组件的名称
49.<property name="projectname.componentname.home"
value="${projectname.components.home}/componentname"/>
讲解：定义当前组件的目录路径
50.<property name="projectname.componentname.classbindir"
value="${projectname.componentname.home}/lib/ejb"/>
讲解：定义当前组件的ejb编译目录路径
51.<property name="projectname.componentname.ejbjar"
value="${projectname.componentname.home}/build/componentname-ejb.jar"/>
讲解：定义当前组件内的ejb包的路径
52. <property name="projectname.componentname.ejbjar.client"
value="${projectname.componentname.home}/build/componentname-ejb-client.jar"/>
讲解：定义当前组件内的ejb客户端包的路径
54. <!-- define referencescomponentname component -->
讲解：这段为注释，说明以下是定义引入其它组件的变量
55. <property name="projectname.referencescomponentname.name"
value="referencescomponentname"/>
讲解：定义指定组件的名称
56. <property name="projectname.referencescomponentname.home"
value="${projectname.components.home}/referencescomponentname"/>
讲解：定义指定组件的目录路径
57. <property name="projectname.referencescomponentname.classbindir"
value="${projectname.referencescomponentname.home}/lib/ejb"/>
讲解：定义指定组件的ejb编译目录路径
58. <property name="projectname.referencescomponentname.ejbjar"
value="${projectname.referencescomponentname.home}
/build/referencescomponentname-ejb.jar"/>
讲解：定义指定组件内的ejb包的路径
59. <property name="projectname.referencescomponentname.ejbjar.client"
value="${projectname.referencescomponentname.home}
/build/referencescomponentname-ejb-client.jar"/>
讲解：定义指定组件内的ejb客户端包的路径
61. <property name="build.classpath"
value="${jboss.client}/jboss-j2ee.jar:${jboss.client}
/jnp-client.jar:${jboss.client}/jnp-client.jar:${jboss.client}
/jbossmq-client.jar:${jboss.client}/jbosssx-client.jar:${jboss.client}
/concurrent.jar:${jboss.client}/jaas.jar:${jboss.lib}
/jboss-jmx.jar:${jboss.home}/server/${jboss.configuration}
/lib/jbosssx.jar:${jboss.home}/server/${jboss.configuration}
/lib/mail.jar:${servlet-lib.path}:${ejb-classes.dest}:
${web-classes.dest}:${projectname.componentname.classbindir}:
${projectname.componentname.ejbjar.client}:
${projectname.referencescomponentname.classbindir}:
${projectname.referencescomponentname.ejbjar.client}" />
讲解：定义classpath，编译bean时要用到。这是定义classpath的一种方法，下面还有另一种方法。
|
定义classpath
<!-- ================================================================== -->
<!-- define the classpath for compile the component -->
<!-- ================================================================== -->
<path id="base.path">
<pathelement location="${jboss.client}/jboss-j2ee.jar" />
<pathelement location="${jboss.client}/jnp-client.jar" />
<pathelement location="${jboss.client}/jbossmq-client.jar" />
<pathelement location="${jboss.client}/jbosssx-client.jar" />
<pathelement location="${jboss.client}/concurrent.jar" />
<pathelement location="${jboss.client}/jaas.jar" />
<pathelement location="${jboss.lib}/jboss-jmx.jar" />
<pathelement
location="${jboss.home}/server/${jboss.configuration}/lib/jbosssx.jar" />
<pathelement
location="${jboss.home}/server/${jboss.configuration}/lib/mail.jar" />
</path>
讲解：此段定义应用服务器中包文件，如支持ejb的jboss-j2ee.jar、
支持客户端程序的jnp-client.jar、jbossmq-client.jar、jbosssx-client.jar、
支持javamail的mail.jar等。
<path id="project.path">
<path refid="base.path"/>
<pathelement location="${projectname.componentname.classbindir}"/>
<pathelement location="${projectname.componentname.ejbjar.client}"/>
<pathelement location="${projectname.referencescomponentname.classbindir}"/>
<pathelement location="${projectname.referencescomponentname.ejbjar.client}"/>
</path>
讲解：此段定义项目中要用到的包文件。
<path id="web.path">
<path refid="project.path"/>
<pathelement location="${servlet-lib.path}"/>
<pathelement location="${ejb-classes.dest}"/>
</path>
讲解：此段定义在编译servlet时的classpath，${ servlet-lib.path }是系统指定的servlet引擎包。
|
为编译作准备工作
<!-- ================================================================== -->
<!-- removes all created files and directories -->
<!-- ================================================================== -->
<target name="clean" depends="init">
<delete dir="${lib.dir}" />
<delete dir="${build.dir}" />
</target>
讲解：清除build、lib目录下的所有文件和目录。
<!-- ================================================================== -->
<!-- makes sure the needed directory structure is in place -->
<!-- ================================================================== -->
<target name="prepare" depends="init,clean">
<mkdir dir="${lib.dir}" />
<mkdir dir="${lib.dir}/ejb" />
<mkdir dir="${lib.dir}/ejb/meta-inf" />
<mkdir dir="${lib.dir}/web" />
<mkdir dir="${lib.dir}/web/web-inf" />
<mkdir dir="${lib.dir}/web/web-inf/classes" />
<mkdir dir="${lib.dir}/web/web-inf/lib" />
<mkdir dir="${lib.dir}/j2ee" />
<mkdir dir="${lib.dir}/meta-inf" />
<mkdir dir="${lib.dir}/docs/api" />
<mkdir dir="${build.dir}" />
</target>
讲解：创建build中要用到的所有目录，根据需要可以加入自定义的目录如：
<mkdir dir="${lib.dir}/javabean/ " />
|
编译ejb部分
<!-- ================================================================== -->
<!-- compilation of the ejb part of the application -->
<!-- ================================================================== -->
<target name="ejb-classes" depends="prepare">
<javac srcdir="${src.ejb.dir}"
destdir="${ejb-classes.dest}"
includes="com/**"
classpathref="base.path" />
</target>
讲解：此小段用来完成编译ejb和其它help classes。根据需要可以加入一个非常有用的元素：
encoding="${javac.encoding}"
<target name="ejb-meta-inf" depends="prepare">
<copy file="${etc.dir}/ejb-jar.xml"
tofile="${lib.dir}/ejb/meta-inf/ejb-jar.xml" />
<copy file="${etc.dir}/jaws.xml"
tofile="${lib.dir}/ejb/meta-inf/jaws.xml" />
<copy file="${etc.dir}/jboss.xml"
tofile="${lib.dir}/ejb/meta-inf/jboss.xml" />
<copy file="${etc.dir}/jbosscmp-jdbc.xml"
tofile="${lib.dir}/ejb/meta-inf/jbosscmp-jdbc.xml" />
</target>
讲解：此小段用来拷贝ejb部署文件，
在jas中ejb部署文件有jaws.xml、jboss.xml、jbosscmp-jdbc.xml。
<target name="ejb-jar" depends="ejb-classes,ejb-meta-inf">
<jar jarfile="${build.dir}/${name}-ejb.jar"
basedir="${lib.dir}/ejb" />
</target>
讲解：此小段用来把class和部署文件压缩成包文件，这个包文件就是一个ejb组件。
<target name="ejbclientjar" depends="ejb-jar,web-classes">
<copy
file="${projectname.referencescomponentname.home}/build/
${projectname.referencescomponentname.name}-ejb-client.jar"
tofile="${build.dir}/${projectname.referencescomponentname.name}
-ejb-client.jar" />
<jar jarfile="${build.dir}/${name}-ejb-client.jar"
basedir="${lib.dir}/ejb"
excludes="com/projectname/componentname/ejb/componentnameejb.class" />
</target>
讲解：此小段用来把class和部署文件压缩成包文件，以支持客户端运行。
|
编译web部分
<!-- ================================================================== -->
<!-- compilation of the web part of the application -->
<!-- ================================================================== -->
<target name="web-classes" depends="prepare,ejb-jar">
<javac srcdir="${src.servlet.dir}"
destdir="${lib.dir}/web/web-inf/classes"
includes="com/**"
classpath="${build.classpath}" />
</target>
讲解：此小段用来完成编译servlet。
<target name="web-web-inf" depends="prepare">
<copy file="${etc.dir}/jboss-web.xml"
tofile="${lib.dir}/web/web-inf/jboss-web.xml" />
<copy file="${etc.dir}/web.xml"
tofile="${lib.dir}/web/web-inf/web.xml" />
</target>
讲解：此小段用来拷贝web部署文件，在jas中web部署文件有jboss-web.xml。
<target name="war" depends="web-classes,web-web-inf">
<copy todir="${lib.dir}/web" >
<fileset dir="${src.web.dir}"/>
</copy>
<copy
file="${build.dir}/${projectname.referencescomponentname.name}-ejb-client.jar"
tofile="${lib.dir}/web/web-inf/lib/${projectname.referencescomponentname.name}
-ejb-client.jar" />
<jar jarfile="${build.dir}/${name}-web.war"
basedir="${lib.dir}/web" />
</target>
讲解：此小段用来把所有的jsp程序、html、css、图片和部署文件等压缩成war文件。
|
编译j2ee application
<!-- ================================================================== -->
<!-- compilation of the complete j2ee application (both web and ejb) -->
<!-- ================================================================== -->
<target name="j2ee-meta-inf" depends="prepare">
<copy file="${etc.dir}/application.xml"
tofile="${lib.dir}/j2ee/meta-inf/application.xml" />
</target>
讲解：此小段用来拷贝application的部署文件。
<target name="ear" depends="ejb-jar,war,j2ee-meta-inf">
<copy file="${build.dir}/${name}-ejb.jar"
tofile="${lib.dir}/j2ee/${name}-ejb.jar" />
<copy file="${build.dir}/${name}-web.war"
tofile="${lib.dir}/j2ee/${name}-web.war" />
<jar jarfile="${build.dir}/${name}.ear"
basedir="${lib.dir}/j2ee" />
</target>
讲解：此小段用来把ejb组件、支持客户端运行的包和部署文件压缩成ear文件，它就是一个j2ee
application。这里要说明，在进行build时，根据需要可以不生成ear文件。
|
部署application
<!-- =================================================================== -->
<!-- deploy ear file -->
<!-- =================================================================== -->
<target name="deploy-server" depends="ear,war">
<copy todir="${jboss.deploy}">
<fileset dir="${build.dir}" includes="*.ear">
</fileset>
</copy>
</target>
讲解：此小段用来部署application，在jas3.0中${jboss.deploy}是jas的热部署目录。
|
创建组件的api
<!-- =================================================================== -->
<!-- create class and package usage pages -->
<!-- =================================================================== -->
<target name="docs" depends="init">
<javadoc locale="${javadoc.locale}" packagenames="${package.names}.${name}.*"
destdir="${javadoc.dir}"
classpath="${build.classpath}"
encoding="${javadoc.encoding}"
author="${javadoc.author}" version="${javadoc.version}"
use="${javadoc.usage}"
windowtitle="${project.name} ${name} component api"
doctitle="${project.name} ${name} component"
bottom="copyright ${sign.copyright} ${project.date}
${company.signature}. all rights reserved.">
<classpath >
<pathelement path="${lib.dir}/ejb"/>
</classpath>
<sourcepath>
<pathelement path="${src.main.dir}/ejb"/>
</sourcepath>
</javadoc>
</target>
|
讲解：此小段用来创建组件的api。这里强烈要求类设计人员和编码人员按照javadoc定义的标签对源代码进行注释。
确定build的目标
<target name="startbanner">
<echo>+---------------------------------------+</echo>
<echo>+ building ${name} component +</echo>
<echo>+---------------------------------------+</echo>
</target>
<target name="endbanner" depends="main" >
<echo>+---------------------------------------+</echo>
<echo>+ finished ${name} component +</echo>
<echo>+---------------------------------------+</echo>
</target>
<target name="main" depends="startbanner, ejb-jar, ejbclientjar" />
<target name="main2" depends="startbanner, ejb-jar, ejbclientjar,war" />
<target name="main3" depends="startbanner, ejb-jar,
ejbclientjar,war,ear,deploy-server" />
<target name="core" depends="ejb-war" />
<target name="ejb-war" depends="main2,endbanner" />
<target name="deploy" depends="main3,endbanner" />
<target name="all" depends="core, docs" />
|
讲解：此小段用来确定build的目标。缺省目录为core，所以在build不加参数时，系统将只生成jar文件和war文件。如果build时加上参数，系统将根据需要来生成文件，例如：在命令行输入ant deploy，系统将生成jar文件、war文件、ear文件，同时将ear文件进行部署。
开发java项目的build规范
在项目的根目录下定义文件build.properties，文件中定义了项目的共用变量，提供给所有开发人员使用。
在开发一个java项目时，所有的项目build.properties必须以下面的build.properties为模板。
build.properties
开发javabean的build.xml规范
在开发javabean时，所有的javabean必须以下面的build.xml为模板。
javabean build.xml模板
?开发ejb的build.xml规范
在开发ejb时，所有的ejb必须以下面的build.xml为模板。
开发ejb的build.xml模板
? 开发components的build.xml规范
在开发components时，所有的components必须以下面的build.xml为模板。
components的build.xml模板
? 开发application的build.xml规范
a) 在application的根目录下定义文件build.properties，文件中定义了application的共用变量，提供给所有开发人员使用。
在开发一个application时，application下的build.properties必须以下面的build.properties为模板。
application下的build.properties模板
b)在开发application时，所有的application必须以下面的build.xml为模板。
application下的build.xml模板
闽公网安备 35060202000074号