服务器端测试利器--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供第二个连接取回。

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

%>　　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个目的：

　　提供附加的方法，HttpConfigWrapper比javax.servlet.ServletConfig多2个方法

　　setServletName(String)

　　setInitParameter(String,String)

　　// 与在web.xml中设定有同样的效果

　　可以返回包装的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