1. 概要
StrutsTestCase for JUnit是Junit TestCase类的扩展,提供基于Struts框架的代码测试装置。StrutsTestCase同时提供Mock 对象方法和Cactus方法用来实际运行Struts ActionServlet,你既可以通过运行servlet引擎来测试,也可以不通过它。因为StrutsTestCase使用ActionServlet控制器来测试你的代码,因此你不仅可以测试Action对象的实现,而且可以测试mappings,from beans以及forwards声明。
使用StrutsTestCase不启动servlet容器来测试struts应用程序(容器外测试)也属于Mock对象测试,但是与EasyMock不同的是,EasyMock是提供了创建Mock对象的API,而StrutsTest则是专门负责测试Struts应用程序的Mock对象测试框架。
除了容器外测试,StrutsTest也可以很方便的用容器内的测试。
StrutsTestCase当前的版本是StrutsTest2.1.2,支持Servlet2.2和2.3的规范,并且支持Struts1.1,Cactus1.6.1和Junit3.8.1。在这个版本中不支持Struts1.0。如果需要测试struts1.0的应用程序,对应的版本是StrutsTest2.0。可以从http://sourceforge.net/projects/strutstestcase/下载。
2. 使用方法
首先应从StrutsTestCase主页下载该工具,解压后会有一个JAR文件,还有一个例子以及API DOC。编写StrutsTestCase时需将这个JAR文件引入到工程中(和Struts中的JAR文件放在一起),此外由于是对JUnit的扩展,因此还必须将Junit.jar引入到工程中。
上面已经介绍过有两种测试方法,下面分别来简单说明:
1) MockStrutsTestCase(Mock对象测试):通过模拟容器来进行测试。MockStrutsTestCase用一套HttpServlet mock对象在不需要运行Servlet引擎的情况下来模拟容器环境。
2) CactusStrutsTestCase(In-container testing):在真实运行的容器中通过使用Cactus测试框架进行测试。
说明:上述两个类都是对Junit TestCase的扩展。如果要将Mock对象测试方法改为Cactus方法,只需要将我们所定义子类的父类由MockStrutsTestCase改为CactusStrutsTestCase即可,而不需要更改内部代码。
命名规则:对于类的命名没有严格的规范,但个人建议使用Test+要测试的Action名;方法名可以任意取,但注意一点:系统只会自动运行以”test”开头的方法名来进行测试。
下面通过一个我写的一个实例来说明具体使用方法,先来看一个Action(RegisterAction.java)中的代码:
package com.firefly;
import org.apache.struts.action.*;
import javax.servlet.http.*;
/**
* @author firefly
*/
public class RegisterAction extends Action{
public ActionForward execute(ActionMapping mapping,ActionForm form,
HttpServletRequest req, HttpServletResponse res){
RegisterForm rf = (RegisterForm)form;
//String userName = rf.getUserName();
String password1 = rf.getPassword1();
String password2 = rf.getPassword2();
if(password1.equals(password2)){
try{
return mapping.findForward("success");
}
catch(Exception e){
return mapping.findForward("failure");
}
}
return mapping.findForward("failure");
}
}
功能很简单,即查看两次输入的密码是否相同,相同则转到success,否则转到failure。下面是测试代码(TestRegisterAction.java):
package com.firefly;
import servletunit.struts.*;
/**
* @author firefly
*/
public class TestRegisterAction extends MockStrutsTestCase{
public void setUp() throws Exception{
super.setUp();
}
public void tearDown() throws Exception{
super.tearDown();
}
public TestRegisterAction(String testName){
super(testName);
}
public void testSuccessfulLogin(){
setRequestPathInfo("/register");
addRequestParameter("userName","hellking");
addRequestParameter("password1","123");
addRequestParameter("password2","123");
actionPerform();
verifyForward("success");
}
public void testFailedLogin(){
setRequestPathInfo("/register");
addRequestParameter("userName","hellking");
addRequestParameter("password1","123");
addRequestParameter("password2","");
actionPerform();
verifyForward("failure");
}
}
说明:
1) 如果override了setUp()和tearDown()方法,那么必须在第一行显示调用其父类的相应方法,原因很简单,父类在这两个方法中定义了很多内容来保证程序能够按照既定规则执行,所以我们必须加载它。
2) 在测试方法中,我们需要做的第一件事是通知Struts在这个测试中要使用哪一个映射(mapping),我们指定一个和Struts mapping相关联的路径,这与Struts标签库方法中使用的机制相同。
3) 我们接下来要做的是通过request对象传递form bean属性,这同样与Struts所做的相同。
4) 该到运行action的时候了,我们通过使用actionPerform()方法来完成该任务。
5) 最后要检验的是程序运行结果是否和我们所预期的一样,通过调用verifyForward()方法来进行确认。这里还有可能用到其他一些方法,如:assertEquals(),assertNull(),verifyNoActionErrors(),verifyActionErrors()等等。
6) 即使你在test方法中不进行任何测试,系统也不会提示任何错误(这个与Action中execute()方法必须返回ActionMapping有所不同),显示的测试结果仍然为成功。你可以在一个test方法中写多个测试,但个人不建议这样使用,这会给方法的命名及程序的结构带来很大的困扰。此外,test方法中遇到测试失败后便会立即返回,而不是继续向下运行(这和and语句颇有相似之处)。
7) 主要函数和作用:
setRequestPathInfo,设置request的请求
addRequestParameter,将参数和对应的值加入request中
actionPerform,执行这个请求
verifyForward,验证forward的名字是否正确
verifyForwardPath,验证forward的path是否正确
verifyNoActionErrors,验证在action执行过程中没有ActionError产生
verifyActionErrors,验证在action执行过程中产生的ActionError集合的内容
详细请查看API DOC。
下面为一些参考网站:
StrutsTestCase主页:http://sourceforge.net/projects/strutstestcase/
API DOC:http://strutstestcase.sourceforge.net/api/index.html
如果需要进一步了解Mock Objects和Cactus测试框架,可以去其官方网站:
Mock Objects:http://www.mockobjects.com/