用StrutsTestCase测试Struts应用程序
一、Struts测试概述
一个具有良好系统架构的J2EE应用程序至少有三层组成,即表现层,商业层和系统
集成层(包括数据存取以及和其他系统集成),目前,Struts是应用比较广泛,实现MVC2模式应用于表现层的一种技术. 在这里面,Struts Action主要用来完成一些简单的数据校验,转换,以及流程转发控制(注意:这里流程不是业务规则). 因此在对整个应用程序进行测试时,我们同时也要测试Struts Action.
但是,测试Struts Action相对测试简单的JavaBean是比较困难,因为Struts是运行在Web服务器中, 因此要测试Struts Action就必须发布应用程序然后才能测试. 我们想象一下,对于一个拥有上千个JSP page和数百甚至数千Java Classes的大规模应用程序,要把他们发布到诸如Weblogic之类的应用服务器再测试,需要多少的时间和硬件资源? 所以这种模式的测试是非常费时费力的.
所以,如果有一种办法能够不用发布应用程序,不需要Web服务器就能象测试普通Java Class一样测试Struts Action,那就能极大地加强Struts的可测试性能,使应用程序测试更为容易,简单快速. 现在这个工具来了,这就是StrutsTestCase.
二、StrutsTestCase 概述
StrutsTestCase 是一个功能强大且容易使用的Struts Action开源测试工具,它本身就是在大名鼎鼎的JUnit基础上发展起来的。因此通过和JUnit结合使用能极大加强应用程序的测试并加快应用程序的开发.
StrutsTestCase提供了两者测试方式,模仿方式和容器测试方式. 所谓模仿方式就是有StrutsTestCase本身来模拟Web服务器. 而容器测试方式则需要Web服务器. 本文要讨论的是前者,原因很简单,不需要Web服务器就能象测试普通的Java Class一样测试Struts Action.
三、准备StrutsTestCase和Struts Action/ActionForm/Config
StrutsTestCase是一个开源工具,可以到http://strutstestcase.sourceforge.net下载. 目前最新版本是2.1.3,
如果你使用Servlet2.3就下载StrutsTestCase213-2.3.jar,使用Servlet2.4的就下载StrutsTestCase213-2.4.jar.
另外StrutsTestCase本身就是从JUnit继承的,所以你还需要下载JUnit3.8.1.
在本文中,我们用一个简单的例子来做测试. 假设我们有一张表Hotline(country varchar2(50),pno varchar2(50)),
我们要做的是根据输入条件从这张表检索相应的记录.检索条件是country.
Value Object:
package sample;
public class HotlineDTO implements Serializable{
private String country = "";
private String pno = "";
/**
* Method HotlineActionForm
*
*
*/
public HotlineDTO () {
super();
}
public void setCountry(String country) {
this.country = country;
}
public void setPno(String pno) {
this.pno = pno;
}
public String getCountry() {
return (this.country);
}
public String getPno() {
return (this.pno);
}
}
ActionForm:
package sample;
import org.apache.struts.action.ActionForm;
public class HotlineActionForm extends ActionForm{
private String country = "";
private String pno = "";
/**
* Method HotlineActionForm
*
*
*/
public HotlineActionForm() {
super();
}
public void setCountry(String country) {
this.country = country;
}
public void setPno(String pno) {
this.pno = pno;
}
public String getCountry() {
return (this.country);
}
public String getPno() {
return (this.pno);
}
}
Action Class:
public class SearchHotlineAction extends Action {
public ActionForward execute(ActionMapping mapping, ActionForm form, HttpServletRequest request,
HttpServletResponse response) throws Exception {
String target = "";
try{
//调用HotlineDAO检索hotline
String country=((HotlineActionForm)form).getCountry();
List hotlineList = HotlineDAO.getHotlineList(country);
if(hotlineList!=null && hotlineList.size()>0){
request.setAttribute("hotlineList",hotlineList);
target = "hotlineList";
}else{
target = "notfound";
}
}catch(Exception ex){
....
}
}
Struts Config:
<struts-config>
<form-beans>
<form-bean name="hotlineActionForm" type="sample.HotlineActionForm" />
....... </form-beans> <action-mappings>
<action path="/SearchHotline"
name="hotlineActionForm"
type="sample.SearchHotlineAction "
scope="request"
validate="false">
<forward name="hotlineList" path="/hotlineList.jsp"/>
<forward name="notfound" path="/searchHotline.jsp"/>
</action>
.....
<action-mappings>
........ <struts-config>
四、初试StrutsTestCase
当采用模拟方式时,所有的StrutsTestCase测试Class都是从MockStrutsTestCase继承下来的.
下面我们就创建一个最简单的测试Class.
public class SearchHotlineAction extends MockStrutsTestCase {
public void setUp()throws Exception{
}
public void tearDown()throws Exception{
}
public void testSearchHotline() throws Exception{
setRequestPathInfo("/SearchHotline.do");
addRequestParameter("country", "CN");
actionPerform();
}
}
上面的Class相信用过JUnit的朋友都很熟悉.
好了,一个简单的测试例子就完成了,如果你用的是Eclipse就选择Run-Run...-JUnit-New就可以直接运行.不需要发布你的程序,不需要任何的Web服务器支持,就可以测试Struts Action,这就是StrutsTestCase带来的好处.下面简单地介绍一下它是怎么工作的.
在上面的例子中,我们调用setRequestPathInfo()告诉StrutsTestCase我们要模拟JSP调用SearchHotline.do这个Action,并且调用addRequestParameter()增加了一个参数country.最后调用actionPerform()运行.
看到这里,大家发现一个问题没有? 在上面Action的源代码里我们是通过
String country=((HotlineActionForm)form).getCountry();
也就是ActionForm来取得输入的参数值,可我们在testSearchHotline()方法里并没有设置ActionForm?
那么它是怎么出来的呢? 其实大家如果熟悉Struts的运行流程的话就知道,JSP接受用户的输入并发请求时都是类似这样的http://hostname/servletName?param1=value1¶m2=value2. 只是Struts接受到这些参数后再根据Struts Config里的Action和ActionForm的映射把他们转为ActionForm后传给Action的.
在上面的例子,我们只是简单地运行了Action,那么Action是否正确执行以及返回的结果是不是我们想要的呢?
我们继续完善一下testSearchHotline()这个Method.
public void testSearchHotline() throws Exception{
setRequestPathInfo("/SearchHotline.do");
addRequestParameter("country", "CN");
actionPerform();
verifyNoActionErrors();
verifyForward("hotlineList");
assertNotNull(request.getAttribute("hotlineList"));
List hotlineList = (List) request.getAttribute("hotlineList");
for (Iterator it = hotlineList.iterator();it.hasNext();){
....
}
}
我们在actionPerform()后增加了几行语句来断定Struts Action是否正确执行.
verifyNoActionErrors() -- 判断Action里没有任何的Action;
verifyForward("hotlineList") -- 判断Action确实转发到hotlineList;
assertNotNull(request.getAttribute("hotlineList")) -- 判断Action确实返回了hotlineList并且不为空
到这里,我们已经基本上讨论完了StrutsTestCase的核心部分. 从头到尾,我们没有发布应用程序,也不需要Web服务器,对我们来讲,Struts Action就象普通的Java Class一样容易调试测试.这就是StrutsTestCase给我们带来的方便.
五、深入StrutsTestCase
除了以上我们用到的几个断定和校验方法外,StrutsTestCase还提供了其他几个方法便于我们测试Struts Action. 下面我一一讲述,具体的大家可以参考文档.
verifyActionErrors/Messages -- 校验ActionActionServlet controller 是否发送了ActionError或ActionMessage. 参数为ActionError/Message Key
verifyNoActionErrors/Messages --校验ActionActionServlet controller 没有发送ActionError或ActionMessage
VerifyForward -- 校验Action是否正确转发到指定的ActionForward.
VerifyForwardPath -- 校验Action是否正确转发到指定的URL
verifyInputForward -- 校验Action是否转发到Action Mapping里的input属性
verifyTilesForward/verifyInputTilesForward--和以上类似,应用程序使用到tiles时用的
六、关于Web.xml和Struts-Config.xml
缺省情况下,StrutsTestCase认为你的Web.xml和struts-config.xml的路径分别是:
/WEB-INF/web.xml和/WEB-INF/struts-config.xml
1. 假如你的web.xml/struts-config.xml的路径是d:/app/web/WEB-INF/web.xml(struts-config.xml)的话,就需要把d:/app/web加到classpath.
2. 假如你的struts config是strust-config-module.xml,那么必须调用setConfigFile()设置你的struts config文件
七、结束语
J2EE应用程序的测试在开发过程中占有相当重要的位置,利用StrutsTestCase能极大方便你测试基于Struts的应用程序.