[原创]ECLIPSE环境下利用ANT进行JSF开发入门(三)

1 <?xml version="1.0"?>
2
3 <project basedir=".">
4
5
6
7 <property name="tomcathome" value="F:/Tomcat5.5"/>
8
9 <property name="lib.dir" value="webapp/web/WEB-INF/lib" />
10
11 <property name="deploy.destfile.jar" value="webapp/web/WEB-INF/lib/deploy-myJSF.jar" />
12
13 <property name="deploy.destdir.class" value="webapp/web/WEB-INF/classes/webapp/src/com/corejsf" />
14
15 <property name="deploy.properties.from" value="build/webapp/src/com/corejsf" />
16
17 <property name="deploy.properties.to.build" value="build/webapp/src/com/corejsf" />
18
19 <property name="deploy.properties.to.webinf" value="webapp/web/WEB-INF/classes/webapp/src/com/corejsf" />
20
21
22
23 <path id="build.classpath">
24
25 <pathelement location="${lib.dir}/commons-beanutils.jar" />
26
27 <pathelement location="${lib.dir}/commons-collections.jar" />
28
29 <pathelement location="${lib.dir}/commons-digester.jar" />
30
31 <pathelement location="${lib.dir}/commons-logging.jar" />
32
33 <pathelement location="${lib.dir}/jsf-api.jar" />
34
35 <pathelement location="${lib.dir}/jstl.jar" />
36
37 <pathelement location="${lib.dir}/standard.jar" />
38
39 </path>
40
41
42
43 <target name="clean">
44
45 <echo message="Delete work dir
47 <delete dir="work"></delete> <!--delete webapp cache-->
48
49 <delete dir="lib"></delete>
50
51 <delete dir="build"></delete>
52
53 </target>
54
55
56
57 <target name="init" depends="clean">
58
59 <echo message="Init part of this project
61 <mkdir dir="build"/>
62
63 <mkdir dir="lib"/>
64
65 </target>
66
67
68
69 <target name="compile" depends="init">
70
71 <javac destdir="build">
72
73 <classpath refid="build.classpath"></classpath>
74
75 <src path="webapp/src"></src>
76
77 </javac>
78
79 </target>
80
81
82
83 <target name="mkjar" depends="compile">
84
85 <jar destfile="lib/myjsf.jar" basedir="build">
86
87 <manifest>
88
89 <attribute name="Build-By" value="Bill-Ant" />
90
91 </manifest>
92
93 </jar>
94
95 </target>
96
97
98
99 <target name="deploy" depends="mkjar">
100
101 <copy file="lib/myjsf.jar" tofile="${deploy.destfile.jar}"></copy>
102
103 <copy todir="${deploy.destdir.class}">
104
105 <fileset dir="build/webapp/src/com/corejsf">
106
107 <include name="*.class"/>
108
109 </fileset>
110
111 </copy>
112
113 <copy todir="${deploy.properties.to.build}">
114
115 <fileset dir="${deploy.properties.from}">
116
117 <include name="*.properties"/>
118
119 </fileset>
120
121 </copy>
122
123 <copy todir="${deploy.properties.to.webinf}">
124
125 <fileset dir="${deploy.properties.from}">
126
127 <include name="*.properties"/>
128
129 </fileset>
130
131 </copy>
132
133 </target>
134
135
136
137 <target name="runserver" depends="deploy">
138
139 <exec dir="${tomcathome}/bin" executable="${tomcathome}/bin/startup.bat" ></exec>
140
141 </target>
142
143</project>
144
145
4.编写ANT构建文件

ANT是一个强大的开源构建工具，它可以快速地对整个WEB应用程序进行编译打包部署等工作，以目标的方式来管理不同的任务，ANT把建立一个WEB应用所需做的大量工作都集成在了一起统一地管理起来，这种方式大大地提高了应用构建的效率和灵活性.

针对本文所述的应用我编写了以下这个构建文件，文件名为build.xml:

project是整个构建文件的根，向下看就是属性定义，属性是一个名称/值对，所以property标签就有两个属性，一个是name，另一个是value，属性定义下面是path结点，这一段指定了在编译器编译的时候要用到的jar包的路径.在整个文件中有很多的${}符号，这个符号就是对属性的引用，大括号中是属性名称.

Jar包定义段之后就是各个目标的定义了，目标标签是<target>，目标标签主要用到的属性有name，depends.name指定目标的名称，depends指定目标的依赖特性，当A目标有一个depends=”B”属性是，就说明A的运行依赖于B，在运行A的时候如果没有运行B，ANT会自动地先运行B目标再运行A目标.

在这个文件中定义了6个目标.分别是:clean，init，compile，mkjar，deploy，runserver，其中clean目标用来清除产生的工作目录和过期的类和jar包.在构建前进行清理是一个好习惯.init是进行初始化，是用来建立一些在编译构建过程中需要的文件夹.compile目标就是进行JAVA文件的编译，mkjar目标是把编译后的类文件打成jar包，deploy是把编译好的类文件和jar包部署到WEB-INF中.最后一个目标就是运行TOMCAT服务器.

下面对一些用到的ANT标签进行说明:

<property name="propertyName" value="propertyValue" />:属性定义，name是属性名称，value是属性值

<javac destdir="build">

<classpath refid="build.classpath"></classpath>

<src path="webapp/src"></src>

</javac>:编译JAVA源文件，其子标签src指定要编译的源文件目录;classpath指定查找用户类文件的位置，功能与javac命令的-classpath参数相同.

<jar destfile="dest.jar" basedir="classes_dir" />:打jar包，destfile是jar包文件名，可以包含路径信息;basedir是要打包的class文件目录.也可以用下面的形式:

<jar destfile="dest.jar" basedir="classes_dir">

<manifest>

<attribute name="Built-By" value="${user.name}">

<attribute name="Main-class" value="MainClass">

</manifest>

</jar>

manifest子结点指定为jar包生成一个清单文件，manifest的子结点说明了清单文件中的内容，可见清单文件中的内容也是名称/值对.在上面定义了作者和主类.

<delete dir="${toBeDelete_dir}" /> :删除指定的目录

<mkdir dir="${buildDir}" />:新建目录

<copy file="src/test.java" tofile="src/testCopy.java" /> :复制文件并改名

<move file="src/test.java" tofile="src/testMove.java" /> :仅改名不复制(重命名)

<zip destfile=”test.zip” basedir=”toBeZipDir” />:压缩文件

<exec dir="${tomcathome}/bin" executable="${tomcathome}/bin/startup.bat" /> :执行外部文件.

把上面的构建文件内容复制到WEB应用的根目录下保存为build.xml.

5.编写BAT批处理文件

到现在为止，WEB应用程序部分就完成了.写BAT文件的目的就是把所有要进行的工作都集成起来.这一步不是必要的，但确实非常有用的.要执行本文的WEB应用可以运行如下的批处理文件:

SET ANT_HOME=F:\devSpace\Ant-1.6.2

path=%ANT_HOME%\bin

SET PATH=%PATH%

call ant -f F:\workspace\JSFWebAppEx\build.xml runserver

第一句是设置ANT的HOME目录，第二句是设置ANT.exe的目录，最后一句就是调用ANT，-f参数是指定构建文件路径.runserver是构建文件中的目标名称，因为在本文的构建文件中，runserver依赖于deploy，deploy依赖于mkjar，mkjar依赖于compile，compile依赖于init，init依赖于clean，所以在ANT.EXE中指定运行runserver时，ANT会自动地从第一个目标开始运行.

把上面的批处理文件内容保存到WEB应用的根目录下的run.bat中.

6.运行WEB应用

当TOMCAT运行起来以后就可以在浏览器中观察结果了.注意:如果不知道HTTP的端口号，那么在输入URL以前请先在%TOMCAT_HOME%\conf\server.xml中查看HTTP的端口号.然后输入http://localhost:8888/JSFApp/faces/index.jsp(假设端口号是8888，WEB应用的虚拟根目录是JSFApp).

以上就是进行一个JSF应用的步骤，是一个从什么都没有到最后看到运行页面的全过程.其实不光是JSF，其他所有的JAVA WEB应用都是类似的步骤.