您的当前位置:首页正文

Ant简介

2020-01-15 来源:榕意旅游网
Ant简介

Ant是Apache提供给Java开发人员的构建工具,它可以在Windows OS和Unix OS下运行,它不仅开放源码并且还是一个非常好用的工具。我强烈建议在进行JavaBean、EJB等开发时安装,不建议安装make、makefile等建立在shell思想上的构建工具。 下载Ant

官方网址: http://jakarta.apache.org/ant/ 安装Ant

设置ANT_HOME系统变量和PATH系统变量 在Windows下

假如ant安装目录为c:\\ant,按下面方法设置 set ANT_HOME=c:\\ant set JAVA_HOME=c:\\jdk1.3

set PATH=%PATH%;%ANT_HOME%\\bin 在Unix 和Linux下

假如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进行示例, 在控制台显示的构建信息:查看详细内容。

C:\\product\\cwapoa\\jboss1.3\\src\\components\\sequencegenerator>ant Buildfile: build.xml startbanner:

[echo] +---------------------------------------+

[echo] + Building SequenceGenerator Component + [echo] +---------------------------------------+ init: clean:

[delete] Deleting directory

C:\\product\\cwapoa\\jboss1.3\\src\\components\\sequenc egenerator\\lib

[delete] Deleting directory

C:\\product\\cwapoa\\jboss1.3\\src\\components\\sequenc egenerator\\build prepare:

[mkdir] Created dir:

C:\\product\\cwapoa\\jboss1.3\\src\\components\\sequencegener

ator\\lib

[mkdir] Created dir:

C:\\product\\cwapoa\\jboss1.3\\src\\components\\sequencegener ator\\lib\\ejb

[mkdir] Created dir:

C:\\product\\cwapoa\\jboss1.3\\src\\components\\sequencegener ator\\lib\\ejb\\META-INF [mkdir] Created dir:

C:\\product\\cwapoa\\jboss1.3\\src\\components\\sequencegener ator\\lib\\docs\\api

[mkdir] Created dir:

C:\\product\\cwapoa\\jboss1.3\\src\\components\\sequencegener ator\\build ejb-classes:

[javac] Compiling 7 source files to C:\\product\\cwapoa\\jboss1.3\\src\\component s\\sequencegenerator\\lib\\ejb ejb-meta-inf:

[copy] Copying 1 file to

C:\\product\\cwapoa\\jboss1.3\\src\\components\\sequence generator\\lib\\ejb\\META-INF ejb-jar:

[jar] Building jar:

C:\\product\\cwapoa\\jboss1.3\\src\\components\\sequencegene rator\\build\\sequencegenerator-ejb.jar ejbclientjar:

[jar] Building jar:

C:\\product\\cwapoa\\jboss1.3\\src\\components\\sequencegene rator\\build\\sequencegenerator-ejb-client.jar main:

endbanner:

[echo] +---------------------------------------+

[echo] + Finished SequenceGenerator Component + [echo] +---------------------------------------+ core:

BUILD SUCCESSFUL

Total time: 9 seconds

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的讲解 开始 1. 讲解:encoding=\"UTF-8\"表示XML文件采用UTF-8编码格式,如果要使用GBK编码, 需定义为encoding=\"GBK\"。 3. 讲解:此部分为文件内容的简介,包括文件名称、创建日期、最后修改日期、创建文件的作者、版权。 component Name 表示 文件名称 yyyy-m-dd 表示 创建日期、最后修改日期的格式,如2002-5-1 developer Name 表示 创建文件的作者 Company Name 表示 公司名称或URL 11. … 254. 讲解:此部分定义了一个名称为component Name的项目元素,缺省的任务为\"core\"任务, 根目录为当前目录。component Name表示组件的名称,这里指EJB的名称。 初始化 17. … 63. 讲解:此部分用于初始化所有的变量 18. 讲解:导入项目根目录下build.properties中的全局变量,开发人员也可以在此文件中重新定义全局变量。 19. 20. 21. … 27. … 41. 42. 43. 讲解:定义和Jboss Application Server有关的变量,包括lib目录、client目录、 deploy目录和J2EE Application部署要用到的一些变量。 22. 讲解:定义组件的名称 23. 讲解:定义源代码目录路径 24. 讲解:定义资源目录路径 25. 讲解:定义库目录路径 26. 讲解:定义build目录路径 28. 讲解:定义源代码的主目录路径 29. 讲解:定义存放EJB的源代码目录路径 30. 讲解:定义存放JavaBean的源代码目录路径 31. 讲解:定义存放Servlet的源代码目录路径 32. 讲解:定义存放WEB部分文件(包括JSP程序、HTML文件、图片、CSS文件、JS脚本等)的目录路径 33. 讲解:定义存放组件API的开发文件目录路径 34. 讲解:定义存放EJB的编译代码目录路径 35. 讲解:定义存放JavaBean的编译代码目录路径 36. 讲解:定义WEB目录的类目录路径 37. 讲解:定义WEB目录的库目录名称 38. 讲解:定义压缩文档的名称 45. 讲解:定义项目的组件目录路径 47. 讲解:这段为注释,说明以下是定义当前组件的变量 48. 讲解:定义当前组件的名称 49. 讲解:定义当前组件的目录路径 50. 讲解:定义当前组件的EJB编译目录路径 51. 讲解:定义当前组件内的EJB包的路径 52. 讲解:定义当前组件内的EJB客户端包的路径 54. 讲解:这段为注释,说明以下是定义引入其它组件的变量 55. 讲解:定义指定组件的名称 56. 讲解:定义指定组件的目录路径 57. 讲解:定义指定组件的EJB编译目录路径 58. 讲解:定义指定组件内的EJB包的路径 59. 讲解:定义指定组件内的EJB客户端包的路径 61. 讲解:定义classpath,编译bean时要用到。这是定义classpath的一种方法,下面还有另一种方法。

定义classpath 讲解:此段定义应用服务器中包文件,如支持ejb的jboss-j2ee.jar、 支持客户端程序的jnp-client.jar、jbossmq-client.jar、jbosssx-client.jar、 支持JavaMail的mail.jar等。 讲解:此段定义项目中要用到的包文件。 讲解:此段定义在编译servlet时的classpath,${ servlet-lib.path }是系统指定的Servlet引擎包。

为编译作准备工作 讲解:清除build、lib目录下的所有文件和目录。 讲解:创建build中要用到的所有目录,根据需要可以加入自定义的目录如: 编译EJB部分 讲解:此小段用来完成编译ejb和其它help classes。根据需要可以加入一个非常有用的元素: encoding=\"${javac.encoding}\" 讲解:此小段用来拷贝EJB部署文件, 在JAS中EJB部署文件有jaws.xml、jboss.xml、jbosscmp-jdbc.xml。 讲解:此小段用来把class和部署文件压缩成包文件,这个包文件就是一个EJB组件。 讲解:此小段用来把class和部署文件压缩成包文件,以支持客户端运行。 编译WEB部分 讲解:此小段用来完成编译servlet。 讲解:此小段用来拷贝WEB部署文件,在JAS中WEB部署文件有jboss-web.xml。 讲解:此小段用来把所有的JSP程序、Html、Css、图片和部署文件等压缩成WAR文件。 编译J2EE Application 讲解:此小段用来拷贝Application的部署文件。 讲解:此小段用来把EJB组件、支持客户端运行的包和部署文件压缩成EAR文件,它就是一个J2EE Application。这里要说明,在进行build时,根据需要可以不生成EAR文件。 部署Application 讲解:此小段用来部署Application,在JAS3.0中${jboss.deploy}是JAS的热部署目录。 创建组件的API

讲解:此小段用来创建组件的API。这里强烈要求类设计人员和编码人员按照Javadoc定义的标签对源代码进行注释。 确定build的目标 +---------------------------------------+ + Building ${name} Component + +---------------------------------------+ +---------------------------------------+ + Finished ${name} Component + +---------------------------------------+ 讲解:此小段用来确定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模板

因篇幅问题不能全部显示,请点此查看更多更全内容