服务器端的测试利器－－Cactus简介

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，文件

示例如下：

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.properties

在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.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();

}