服务器端的测试利器－－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，文件示例如下：

    log_server.properties
在cactus.jar中，如果要定制，最好把修改后的log_server.properties打包到cactus.jar中，覆盖原来的文件。

三、如何编写测试案例（TestCase）

写一个Test Case的步骤：
1.    Import

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();
    }

原文转自：http://www.ltesting.net