Ant
实战篇 (一)
修订者:
黄 凯
E_mail:
hk_sz@163.com
前 言
由于现在公司进行Unit Test Case的整理阶段,所以抽空对Ant和Junit技术进行了一下了解,以下是集合了众家所长之精华(考虑到是按我的思路总结的,也许不能完全表述原作者的思路,所以在参考中我把所有参考过的文章网址或书籍都罗列了出来,大家有时间不妨去看看原文)。
如果对Ant部分参数不明白的话,请参看《Ant理论篇》系列或ant自带的文档。
目 录
一、 Ant 使用实例
1.1
通过 Ant 的 copt task 将当前目录下最近更新的文件(按系统时间来区分)文件提交至指定目录
1.2
用 Ant 开发 java 程序
1.3
ant 结合 junit 进行软件自动测试
1.4
ant 开发和部署 web 应用程序
1.5
ant 打包( jar ) 应用程序
1.6
ant 开发 EJB 应用程序
参考
一、
Ant
使用实例
1.1
通过
Ant 的 copt task 将当前目录下最近更新的文件(按系统时间来区分)文件提交至指定目录
1
前提:在D盘下创建两个文件夹test1和test2,并在test1中创建build.xml文件,内容如下:
<?
xml version
=
"
1.0
"
?>
< project name =" test " default =" upload ">
<!-- 设置提交的根路径以及提交目录属性 -->
< property name =" dest_drive " value =" D:\ " />
< property name =" dest_dir " value =" ${dest_drive}\test2\test " />
<!-- 如果没有提交目录的话,创建提交目录 -->
< target name =" create_dir ">
< mkdir dir =" ${dest_dir} " />
</ target >
<!-- 通过copy task提交当前目录下除build.xml外所有非临时文件 -->
< target name =" upload " depends =" create_dir ">
< copy todir =" ${dest_dir} ">
< fileset dir =" . ">
< exclude name =" **\build.xml "/>
</ fileset >
</ copy >
</ target >
</ project >
2>进入DOS命令行状态,运行D:\test1>ant。进入test2中进行检查,看是否已经建立好了test子目录并且将test1中的文件除build.xml外都已经提交过来。如果这时你再运行ant,会发现其没有任何操作提示,因为已经没有新文件需要提交了。
注:有兴趣的朋友不妨将其中一个文件更新一下再执行一次,你会发现 upload: 下会出现新的信息。
1.2 用Ant开发java程序,以HelloWord为例
1. 本次实例的目录结构:
D:\test 主目录
--\src 源程序目录
--
\classes 编译后的class文件目录
首先在D盘创建test目录和src子目录。
2. 在src子目录下创建HelloWord.java文件,内容如下:
public
class
HelloWord
{
public
static
void
main(String args[])
{
System.out.println(
"
Hello World!
"
);
}
}
3.在test主目录下创建build.xml文件,内容如下:
<?
xml version
=
"
1.0
"
?>
<
project
default
=
"
build
"
basedir
=
"
.
"
>
<
property name
=
"
appname
"
value
=
"
HelloWord
"
/>
<
property name
=
"
base
"
value
=
"
D:\test
"
/>
<
property name
=
"
src
"
value
=
"
src
"
/>
<
property name
=
"
build
"
value
=
"
classes
"
/>
<
property name
=
"
myclasspath
"
value
=
"
${base}\${build}
"
/>
<
target name
=
"
build
"
>
<
mkdir dir
=
"
${build}
"
/>
<
javac srcdir
=
"
${src}
"
destdir
=
"
${build}
"
>
<
include name
=
"
**/*.java
"
/>
</
javac
>
</
target
>
<
target name
=
"
run
"
depends
=
"
build
"
>
<
exec executable
=
"
java
"
>
<
arg line
=
"
-classpath ${myclasspath} ${appname}
"
/>
</
exec
>
</
target
>
<
target name
=
"
clean
"
>
<
delete includeEmptyDirs
=
"
true
"
>
<
fileset dir
=
"
${build}
"
/>
</
delete
>
</
target
>
</
project
>
为了提高程序的可移植性,我们将property分离出来组成build.properties文件。新的build.xml文件和build.properties文件内容如下:
build.properties文件:
appname
=
HelloWord
src
=
src
build
=
classes
myclasspath
=
$
{basedir}
\\$
{build}
build.xml文件(property部分通过file调用build.properties即可):
<?
xml version
=
"
1.0
"
?>
<
project
default
=
"
build
"
basedir
=
"
.
"
>
<
property file
=
"
build.properties
"
/>
<
target name
=
"
build
"
>
<
mkdir dir
=
"
${build}
"
/>
<
javac srcdir
=
"
${src}
"
destdir
=
"
${build}
"
>
<
include name
=
"
**/*.java
"
/>
</
javac
>
</
target
>
<
target name
=
"
run
"
depends
=
"
build
"
>
<
exec executable
=
"
java
"
>
<
arg line
=
"
-classpath ${myclasspath} ${appname}
"
/>
</
exec
>
</
target
>
<
target name
=
"
clean
"
>
<
delete includeEmptyDirs
=
"
true
"
>
<
fileset dir
=
"
${build}
"
/>
</
delete
>
</
target
>
</
project
>
4. 在test目录下运行ant查看执行结果。
再运行ant run和ant clean看看会怎么样,:)
1.3
ant
结合
junit
进行软件自动测试
1> 用ant结合junit启动基本编译和测试的自动过程如下:
★ 执行 JUnit 测试
★ 捕获测试结果,将结果记录到 XML 文件或其它格式的文件
★ 将结果转化为基于 XSL 格式的测试报告
★ 将这个报告转化为 HTML 格式
★ 用电子邮件发送报告
一旦捕获结果,就可以使用XML格式化器将每个测试套件运行的故障和错误数,连同软件包和类名还有测试套件的执行时间一起引入。对于每个测试套件,都有以下信息被捕获:
☆ 测试案例的名称
☆ 执行的持续时间
☆ 故障或错误的类型(如果适用)
☆ 任何故障或错误的详细信息
2> 本次实例的目录结构:
D:\car 主目录
\src 源程序目录
\classes编译后的class文件目录
\etc 其他
\xsl XSL文件目录
首先在D盘创建car目录、src子目录和etc子目录,并从%ANT_HOME%\etc下拷贝junit-noframes.xsl文件至D:\car\etc\xsl子目录下。
3> 从
http://download.sourceforge.net/junit/junit3.8.zip
下载,解压至D盘,将其目录下的junit.jar文件拷贝至%ANT_HOME%\lib目录下。
4> 在src子目录下新建Car.java以及testCar.java文件。
Car.java的内容如下:
//将要被测试的类
public class Car
{
public int getWheels()
{
return 3;
}
}
testCar.java的内容如下:
//执行测试的类
import junit.framework.*;
public class testCar extends TestCase
{
protected int expectedWheels;
protected Car myCar;
public testCar(String name)
{
super(name);
}
protected void setUp()
{
expectedWheels = 4;
myCar = new Car();
}
public static Test suite()
{
return new TestSuite(testCar.class);
}
public void testGetWheels()
{
assertEquals(expectedWheels, myCar.getWheels());
}
}
5> 在build.xml和build.properties文件。
buil.properties文件内容如下:
src.dir=src
build.dir=classes
xsl.dir=etc/xsl
report.dir=report
build.xml文件内容如下:
<?xml version="1.0"?>
<project default="build" basedir=".">
<property file="build.properties" description="Transfer property from .properties file"/>
<target name="build" description="Build the work directory">
<mkdir dir="${build.dir}" />
<mkdir dir="${report.dir}" />
<javac srcdir="${src.dir}" destdir="${build.dir}">
<include name="**/*.java" />
</javac>
</target>
<target name="junit" depends="build" description="Execute Unit Tests">
<tstamp/>
<junit printsummary="yes">
<classpath>
<pathelement location="${build.dir}"/>
</classpath>
<formatter type="xml" />
<batchtest todir="${report.dir}">
<fileset dir="${src.dir}">
<include name="**/testCar.java" />
</fileset>
</batchtest>
</junit>
<junitreport todir="${report.dir}">
<fileset dir="${report.dir}">
<include name="TEST-*.xml"/>
</fileset>
<report format="noframes" styledir="${xsl.dir}" todir="${report.dir}"/>
</junitreport>
</target>
<target name="clean" description="Delete the work directory">
<delete includeEmptyDirs="true">
<fileset dir="${build.dir}"/>
<fileset dir="${report.dir}"/>
</delete>
</target>
</project>
6> 在D:\car目录下运行ant junit,
这样在car\report中生成了
junit-noframes.html
、TESTS-TestSuites.xml和TEST-testCar.xml文件,打开junit-noframes.html查看结果。运行ant clean恢复原状。
1.4
ant
开发和部署
web
应用程序
1> 前提:
★ 完成《JBuilder9+Weblogic7实战篇之Filter运用篇》,因为这是我们这次打包的实例;
★ 将Filter整个目录拷贝至D盘,我是用Jbuilder编辑的,所以除classes文件夹和Filter.war文件删除外,其他的保留,我们要用到的相关目录结构如下:
D:\Filter
src java源文件目录
Filter JSP文件及配置文件目录
WEB-INF 配置文件目录
2> 由于不是在Jbuilder环境进行编译,所以需要在CLASSPATH中定义servlet的路径。首先,我们到
http://java.sun.com/products/servlet/download.html
下载
http://java.sun.com/webapps/download/Redirect/103537442/5847479377282807053505607246086069333228938
633594669477228720286350602472859339008063305596058473206-4908/servlet-2_3-fcs-classfiles.zip
然后将包含servlet-2_3-fcs-classfiles.zip的整个路径加到CLASSPATH中。
3> 在D:\Filter目录下创建build.properties和Filter.xml文件。
build.properties文件内容如下:
WebLogic.user_projects.mydomain.applications=C:/bea/user_projects/mydomain/applications
filter=Filter
dest=classes.ant
src=src
Filter.xml文件内容如下:
<?xml version="1.0"?>
<project default="init" basedir=".">
<property file="build.properties"/>
<target name="init" description="initialization">
<mkdir dir="${dest}" />
<javac destdir="${dest}">
<src path="${src}"/>
</javac>
</target>
<target name="war" depends="init">
<war destfile="Filter.war" webxml="${filter}/WEB-INF/web.xml" compress="false">
<classes dir="${dest}">
<include name="**/*.*"/>
</classes>
<fileset dir="${filter}">
<include name="**/*.*"/>
</fileset>
</war>
</target>
<target name="deploy" depends="war">
<copy todir="${WebLogic.user_projects.mydomain.applications}">
<fileset dir="." includes="Filter.war"/>
</copy>
</target>
<target name="rebuild" depends="clean,war">
<copy todir="${WebLogic.user_projects.mydomain.applications}">
<fileset dir="." includes="Filter.war"/>
</copy>
</target>
<target name="clean">
<delete includeEmptyDirs="true">
<fileset dir="${dest}"/>
<fileset dir=".">
<include name="Filter.war"/>
</fileset>
<fileset dir="${WebLogic.user_projects.mydomain.applications}">
<include name="Filter.war"/>
</fileset>
</delete>
</target>
</project>
4> 启动Weblogic server,在D:\Filter目录下运行ant deploy -buildfile Filter.xml进行部署,打开IE,
在地址栏输入http://localhost:7001/Filter/login.jsp查看是否能正常运行。然后,你可以修改Filter子目录下的login.jsp文件中的代码,
运行ant rebuild -buildfile Filter.xml重新部署,然后刷新http://localhost:7001/Filter/login.jsp查看显示修改后的结果是否正确。
5> 以上第3步是将web应用程序通过拷贝到%BEA_HOME%\user_projects\mydomain\applications目录下进行部署的,
其实ant提供了对应于Weblogic的发布任务<serverdeploy>。请用下面代码替换掉build.properties和Filter.xml文件中的代码。
build.properties文件内容如下:
WebLogic.user_projects.mydomain.applications=C:/bea/user_projects/mydomain/applications
filter=Filter
dest=classes.ant
src=src
weblogic.server=C:/bea/weblogic700/server
username=training
user.password=training
weblogic.filter=C:/bea/user_projects/mydomain/myserver/upload/Filter
Filter.xml文件内容如下:
<?xml version="1.0"?>
<project default="init" basedir=".">
<property file="build.properties"/>
<target name="init" description="initialization">
<mkdir dir="${dest}" />
<javac destdir="${dest}">
<src path="${src}"/>
</javac>
</target>
<target name="war" depends="init">
<war destfile="Filter.war" webxml="${filter}/WEB-INF/web.xml" compress="false">
<classes dir="${dest}">
<include name="**/*.*"/>
</classes>
<fileset dir="${filter}">
<include name="**/*.*"/>
</fileset>
</war>
</target>
<target name="deploy" depends="war">
<serverdeploy action="deploy" source="Filter.war">
<weblogic application="Filter"
server="t3://127.0.0.1:7001"
classpath="${weblogic.server}/lib/weblogic.jar"
username="${username}"
password="${user.password}"
component="Filter:myserver"
debug="true"/>
</serverdeploy>
</target>
<target name="redeploy" depends="war">
<serverdeploy action="update" source="Filter.war">
<weblogic application="Filter"
server="t3://127.0.0.1:7001"
classpath="${weblogic.server}/lib/weblogic.jar"
username="${username}"
password="${user.password}"
component="Filter:myserver"
debug="true"/>
</serverdeploy>
</target>
<target name="list">
<serverdeploy action="list">
<weblogic application="Filter"
server="t3://127.0.0.1:7001"
classpath="${weblogic.server}/lib/weblogic.jar"
username="${username}"
password="${user.password}"
debug="true"/>
</serverdeploy>
</target>
<target name="undeploy">
<serverdeploy action="undeploy">
<weblogic application="Filter"
server="t3://127.0.0.1:7001"
classpath="${weblogic.server}/lib/weblogic.jar"
username="${username}"
password="${user.password}"
debug="true"/>
</serverdeploy>
</target>
<target name="delete">
<serverdeploy action="delete" source="Filter.war">
<weblogic application="Filter"
server="t3://127.0.0.1:7001"
classpath="${weblogic.server}/lib/weblogic.jar"
username="${username}"
password="${user.password}"/>
</serverdeploy>
</target>
<target name="clean">
<delete includeEmptyDirs="true">
<fileset dir="${dest}"/>
<fileset dir="${weblogic.filter}"/>
<fileset dir=".">
<include name="Filter.war"/>
</fileset>
<fileset dir="${WebLogic.user_projects.mydomain.applications}">
<include name="Filter.war"/>
</fileset>
</delete>
</target>
</project>
6> 启动Weblogic server,在D:\Filter目录下运行ant deploy -buildfile Filter.xml进行部署,
打开
IE,在地址栏输入
http://localhost:7001/console/
后在左边的单击
mydomain\deployments\Web Applications\Filter
,然后在右边单击“
deploy
”选项栏,查看是否部署成功。
再
开一个IE,在地址栏输入http://localhost:7001/Filter/login.jsp查
看是否能正常运行。接下来运行ant undeploy -buildfile Filter.xml进行取消部署,
刷新
http://localhost:7001/console/
的
浏览器,查看部署是否成功取消。
然后,你可以修改Filter子目录下的login.jsp文件中的代码,
再运行
ant redeploy -buildfile Filter.xml
进行重新部署,
再刷新
http://localhost:7001/console/
的
浏览器,查看
部署是否成功。
然后刷新http://localhost:7001/Filter/login.jsp查看显示修改后的结果是否正确。
最后,从Web Applications中删除Filter,运行ant delete -buildfile Filter.xml进行删除。
刷新
http://localhost:7001/console/
的浏览器,查看是否成功(在左边的单击
mydomain\deployments\Web Applications
)。