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的实例 创建一些Server对象(HttpServletRequest、ServletConfig、ServletContext)的Cactus wrapper 如果需要,创建一个HTTP Session 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 Proxy 客户端打开2个HTTP连接,一个用于执行测试并取回Servlet输出流;另一个取回测试结果。测试结果被存储在一个变量中,并被放置到ServletContext供第二个连接取回。 JSP Redirector Proxy
客户端打开2个连接,一个用于连接JSP Redirector执行test,取回JSP 输出流;第二个连接Servlet Redirector取回test结果。测试结果同样被存储在一个变量中,并被放置到ServletContext供第二个连接取回。
二、配置
client端 cactus.properties 配置Server端转向器的地址 cactus.servletRedirectorURL = http://localhost:8080/test/ServletRedirector/ (注意:结尾为“/”) cactus.jspRedirectorURL = http://localhost:8080/test/JspRedirector/ cactus.filterRedirectorURL = http://localhost:8080/test/FilterRedirector/ log_client.properties 配置log4j 在cactus.jar中已包含了一个确省的log_client.properties、log_server.properties文件。如果要提供自己的log_client.properties文件,要把此文件放在classpath中,并且一定要放在cactus.jar之前。
server端 web.xml 为了与上面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,文件示例如下:
- <%@page import="org.apache.cactus.server.*" session="false" %><%
- JspImplicitObjects objects = new JspImplicitObjects();
- objects.setHttpServletRequest(request);
- objects.setHttpServletResponse(response);
- objects.setServletConfig(config);
- objects.setServletContext(application);
- objects.setJspWriter(out);
- objects.setPageContext(pageContext);
-
- JspTestRedirector redirector = new JspTestRedirector();
- redirector.doGet(objects);
- %>
log_server.properties 在cactus.jar中,如果要定制,最好把修改后的log_server.properties打包到cactus.jar中,覆盖原来的文件。
三、如何编写测试案例(TestCase)
写一个Test Case的步骤: 1. Import
- import org.apache.cactsu.*;
- 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.HttpServletRequestWrapper response ?C javax.servlet.http.HttpServletResponse config ?C org.apache.cactus.server.ServletConfigWrapper 包装config有2个目的: 4) 提供附加的方法,HttpConfigWrapper比javax.servlet.ServletConfig多2个方法 setServletName(String) setInitParameter(String,String) // 与在web.xml中设定有同样的效果 5) 可以返回包装的ServletContext, session ?C 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.HttpServletRequestWrapper response ?C javax.servlet.http.HttpServletResponse config ?C org.apache.cactus.server.ServletConfigWrapper 包装config有2个目的: 6) 提供附加的方法,HttpConfigWrapper比javax.servlet.ServletConfig多2个方法 setServletName(String) setInitParameter(String,String) // 与在web.xml中设定有同样的效果 7) 可以返回包装的ServletContext, session ?C 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(); }
|
|