分享
 
 
 

用ANT构造Application

王朝other·作者佚名  2008-05-31
窄屏简体版  字體: |||超大  

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模板

 
 
 
免责声明:本文为网络用户发布,其观点仅代表作者个人观点,与本站无关,本站仅提供信息存储服务。文中陈述内容未经本站证实,其真实性、完整性、及时性本站不作任何保证或承诺,请读者仅作参考,并请自行核实相关内容。
2023年上半年GDP全球前十五强
 百态   2023-10-24
美众议院议长启动对拜登的弹劾调查
 百态   2023-09-13
上海、济南、武汉等多地出现不明坠落物
 探索   2023-09-06
印度或要将国名改为“巴拉特”
 百态   2023-09-06
男子为女友送行,买票不登机被捕
 百态   2023-08-20
手机地震预警功能怎么开?
 干货   2023-08-06
女子4年卖2套房花700多万做美容:不但没变美脸,面部还出现变形
 百态   2023-08-04
住户一楼被水淹 还冲来8头猪
 百态   2023-07-31
女子体内爬出大量瓜子状活虫
 百态   2023-07-25
地球连续35年收到神秘规律性信号,网友:不要回答!
 探索   2023-07-21
全球镓价格本周大涨27%
 探索   2023-07-09
钱都流向了那些不缺钱的人,苦都留给了能吃苦的人
 探索   2023-07-02
倩女手游刀客魅者强控制(强混乱强眩晕强睡眠)和对应控制抗性的关系
 百态   2020-08-20
美国5月9日最新疫情:美国确诊人数突破131万
 百态   2020-05-09
荷兰政府宣布将集体辞职
 干货   2020-04-30
倩女幽魂手游师徒任务情义春秋猜成语答案逍遥观:鹏程万里
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案神机营:射石饮羽
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案昆仑山:拔刀相助
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案天工阁:鬼斧神工
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案丝路古道:单枪匹马
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案镇郊荒野:与虎谋皮
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案镇郊荒野:李代桃僵
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案镇郊荒野:指鹿为马
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案金陵:小鸟依人
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案金陵:千金买邻
 干货   2019-11-12
 
推荐阅读
 
 
 
>>返回首頁<<
 
靜靜地坐在廢墟上,四周的荒凉一望無際,忽然覺得,淒涼也很美
© 2005- 王朝網路 版權所有