Cactus是一套简单,易于使用的服务器端测试框架,可以使开发人员很轻松的测试服务器端的程序。Cactus是Junit的一个扩展,但是它又和Junit有一些不同。Cactus的测试分为三种不同的测试类别,JspTestCase,ServletTestCase, FilterTestCase, 而不是像Junit就一种TestCase。Cactus的测试代码有服务器端和客户端两个部分,他们协同工作。在测试服务器端的应用时,Cactus和Junit相比有什么优势呢?
一般EJB或者servlet, jsp都是运行在服务器上,如果你使用junit测试的话,你的测试是在客户端,这使的运行环境和测试环境处于不同的系统环境中,这个有时候会不同的测试结果。
EJB2.0中的Local interface ,不允许远程调用。用Junit不好测试,而Cactus的redirector位于服务器端,可以和EJB运行在一个容器中,这使得它可以直接访问Local Interface。
在一个EJB的应用中,一般都会有一些前端应用来访问EJB,例如:jsp,servlet,Javabean。这就意味着你需要一个测试框架来测试这些前端的组件。Cactus提供了所有这些组件的测试方法。
Cactus和ant很好的结合在一起,可以很容易的完成自动化测试,减少了很多工作量。
一、工作原理
1. JUnit Test Runner调用YYYTestCase.runTest(),这个方法寻找beginXXX(ServletTestRequest )
2. YYYTestCase.runTest()打开一个到Redirector Proxy的HTTP连接
3. Redirector Proxy进行如下操作
创建Test class的实例u
创建一些Server对象(HttpServletRequest、ServletConfig、ServletContext)的Cactusu wrapper
如果需要,创建一个HTTP Sessionu
4. Redirector Proxy通过Reflection,执行Test类的setUP()、testXXX()、tearDown()
5. testXXX()调用Server side classes的方法,并通过JUnit的assert API来验证测试结果
6. 如果测试失败,testXXX()方法抛出例外,Redirector Proxy会捕获例外
7. Redirector Proxy向客户端返回例外的有关信息,JUnit会将这些信息打印出来
8. 如果没有发生例外,YYYTestCase.runTest()寻找并执行endXXX(HttpURLConnection),在这儿你可以使用JUnit asserts检查返回的HTTP Header、servlet output stream
Servlet Redirector Proxyn
客户端打开2个HTTP连接,一个用于执行测试并取回Servlet输出流;另一个取回测试结果。测试结果被存储在一个
变量中,并被放置到ServletContext供第二个连接取回。
JSP Redirector Proxyn
客户端打开2个连接,一个用于连接JSP Redirector执行test,取回JSP 输出流;第二个连接Servlet Redirector取回
test结果。测试结果同样被存储在一个变量中,并被放置到ServletContext供第二个连接取回。
二、配置
client端
cactus.propertnies 配置Server端转向器的地址
cactus.servletRedirectorURL = http://localhost:8080/test/ServletRedirector/ (注意:结尾为“/”)
cactus.jspRedirectorURL = http://localhost:8080/test/JspRedirector/
cactus.filterRedirectorURL = http://localhost:8080/test/FilterRedirector/
log_client.propertnies 配置log4j
在cactus.jar中已包含了一个确省的log_client.properties、log_server.properties文件。如果要提供自己的log_client.properties文件,要把此文件放在classpath中,并且一定要放在cactus.jar之前。
server端
web.xmln
为了与上面client端的cactus.properties相配合,需要在server端部署一个命名为test的应用,并写一个配置文件
web.xml,例示如下:
<web-app>
<filter>
<filter-name>FilterRedirector</filter-name>
<filter-class>org.apache.cactus.server.FilterRedirector</filter-class>
</filter>
<filter-mapping>
<filter-name>FilterRedirector</filter-name>
<url-pattern>/FilterRecirector/</url-pattern>
</filter-mapping>
...同样配置ServletRedirector、JspRedirector的类及URL,特殊之处是JspRedirector的类配置为
<servlet>
<servlet-name>JspRedirector</servlet-name>
<jsp-file>...(/someDir)/jspRedirector.jsp</jsp-file>
<init-param>
<param-name>...</param-name>
<param-value>...</param-value>
</init-param>
</servlet>
注:如果你使用了JspRedirector(即继承了JspTestCase),你必须把jspRedirector.jsp拷贝到一个目录
(web.xml中的someDir)。jspRedirector.jsp文件在sample/web/test中,作为proxy调用server端的unit tests,文件
示例如下:
1. <%@page import ="org.apache.cactus.server.*" session="false" %><%
2. JspImplicitObjects objects = new JspImplicitObjects();
3. objects.setHttpServletRequest(request);
4. objects.setHttpServletResponse(response);
5. objects.setServletConfig(config);
6. objects.setServletContext(application);
7. objects.setJspWriter(out);
8. objects.setPageContext(pageContext);
9. JspTestRedirector redirector = new JspTestRedirector();
10. redirector.doGet(objects);
11. %>
log_server.propertnies
在cactus.jar中,如果要定制,最好把修改后的log_server.propert
三、如何编写测试案例(TestCase)
写一个Test Case的步骤:
1. Import
1. import org.apache.cactsu.*;
2. import junit.framework.*;
2. Extends a cactus TestCase
public class TestSampleServlet extends Servlet/Jsp/FilterTestCase {
3. 标准JUnit方法
1) constructor
TestSampleServlet (String theName){
super(theName);
} // theName就是Test的Name
2) main(String[]) //启动一个JUnit Test Runner
junit.ui.TestRunner.main(new String[]{TestSampleServlet.class.getName()});
3) suite() //静态方法,返回值为Test
return new TestSuite(TestSampleServlet.class)
4. setUP(), tearDown()
5. testXXX()
一个实例:
public void testXXX(){
SampleServlet servlet = new SampleServlet();
session.setAttribute(“name”,”value”);
servlet.doSomething(request);
assertEquals(“something”,result);
assertEquals(“otherValue”,session.getAttribute(“otherName”));
}
6. beginXXX(WebRequest) //可选
在WebRequest中设置所有的HTTP相关参数,主要有:
setMethod(String)
setAutomaticSession(boolean)
setURL(...)
addParameter(String,String)等。
然后,你可以在testXXX()方法中调用HttpServletRequest的getQueryString()、getHeader()等得到。
注意:这个方法在client端执行,先与testXXX()方法;所以,不要企图去访问任何the class variables that represent API objects (their values are null)。endXXX()也相同。
endXXX(HttpURLConnection) //可选
对于ServletTestCase,提供了如下隐含对象:
request ?C org.apache.cactus.server.HttpServletRequestWrappern
response ?Cn Javax.servlet.http.HttpServletResponse
config ?C org.apache.cactus.server.ServletConfigWrappern
包装config有2个目的:
4) 提供附加的方法,HttpConfigWrapper比Javax.servlet.ServletConfig多2个方法
setServletName(String)
setInitParameter(String,String) // 与在web.xml中设定有同样的效果
5) 可以返回包装的ServletContext,
session ?Cn Javax.servlet.http.HttpSession
提示1:如果使用到任何继承自Javax.servlet.GenericServlet的方法(比如:log()、getServletConfig()等),那么你需要调用servlet的init(ServletConfig)方法来实例ServletConfig对象。举例如下:
public void testXXX(){
MyServletToTest servlet = new MyServletToTest();
servlet.init(config);
…servlet.someMethodToTest();
}
对于JspTestCase,提供了如下隐含对象:
request ?C org.apache.cactus.server.HttpServletRequestWrappern
response ?Cn Javax.servlet.http.HttpServletResponse
config ?C org.apache.cactus.server.ServletConfigWrappern
包装config有2个目的:
6) 提供附加的方法,HttpConfigWrapper比Javax.servlet.ServletConfig多2个方法
setServletName(String)
setInitParameter(String,String) // 与在web.xml中设定有同样的效果
7) 可以返回包装的ServletContext,
session ?Cn Javax.servlet.http.HttpSession
提示1:如果使用到任何继承自Javax.servlet.GenericServlet的方法(比如:log()、getServletConfig()等),那么你需要调用servlet的init(ServletConfig)方法来实例ServletConfig对象。举例如下:
public void testXXX(){
MyServletToTest servlet = new MyServletToTest();
servlet.init(config);
…servlet.someMethodToTest();
}
--作者srx81(来自松耦合空间)