Cactus实例讲解
Cactus简介
． 简介
Cactus实现了对JUnit测试框架的无缝扩展，可以方便地测试服务端应用程序。Cactus可以在下面几种情况下使用：
- 测试Servlet以及任何使用了像HttpServletRequest，HttpServletResponse，……这样的对象的代码。使用ServletTestCase。
- 测试Filter以及任何使用了像FilterConfig，……这样的对象的代码。使用FilterTestCase。
- 测试JSP 。使用ServletTestCase或JspTestCase。
- 测试Taglibs以及任何使用了像PageContext，……这样的对象的代码。使用JspTestCase。
- 测试EJB。ServletTestCase或JspTestCase或FilterTestCase。
Cactus的使用也是非常简单的，你写的测试类只需继承ServletTestCase或者JspTestCase、FilterTestCase（它们都继承了JUnit的TestCase）。写好测试代码后需要启动web容器，然后执行测试代码。在下面的章节中我们将通过例子向你详细讲解。
Cactus项目Apache Jakarta Commons的一个子项目，网址是：http://jakarta.apache.org/commons/cactus/。
． TestCase框架
在Cactus下，我们写的TestCase与JUnit有所不同，先看一段代码，如下：
public class TestSample extendsServletTestCase/JspTestCase/FilterTestCase {public TestSample (String testName) {
super(testName);
}
public void setUp() {
}
public void tearDown() {
}
public void beginXXX(WebRequest theRequest) {
}
public void testXXX() {
}
public void endXXX(WebResponse theResponse) {
}
上面是一个Cactus测试类的完整代码框架，其中的extends部分需要按你所测试的不同目标来继承不同的类（简介中有所描述）。
另外我们注意到两个新的方法beginXXX和endXXX的，这两个方法分别会在testXXX执行前和执行后执行，它们和setUp、tearDown不同的是beginXXX和endXXX会在相应的testXXX前执行，而setUp和tearDown则在每个testXXX方法前都会执行。另外beginXXX和endXXX是客户端代码，所以在这两个方法里是无法使用request这样的服务端对象的。
对于endXXX方法需要另加说明的是，在Cactus v1.1前（包括v1.1），它的形式是这样的public void endXXX(HttpURLConnection theConnection)，而在Cactus v1.2开始它的形式有两种可能：
- public void endXXX(org.apache.cactus.WebResponse theResponse)；
- public void endXXX(com.meterware.httpunit.WebResponse theResponse)；
可以看到区别在于引用的包不同，为什么会这样的呢？因为在v1.2开始Cactus集成了HttpUnit这个组件。如果你熟悉HttpUnit这个组件，我想应该明白为什么要集成HttpUnit。下面我们来看一段代码开比较一下两者的区别：
public void endXXX(org.apache.cactus.WebResponse theResponse) {
String content = theResponse.getText();
assertEquals(content, "<html><body><h1>Hello world!</h1></body></html>");
}
public void endXXX(com.meterware.httpunit.WebResponse theResponse) {
WebTable table = theResponse.getTables()[0];
assertEquals("rows", 4, table.getRowCount());
assertEquals("columns", 3, table.getColumnCount());
assertEquals("links", 1, table.getTableCell(0, 2).getLinks().length);
}
当然，在实际应用中你需要根据不同的需要来选择不同的endXXX。两个WebResponse的差别可以参见两者各自的API Doc，这里就不再多说了。
如何在Cactus里写测试
． 写测试代码
首先，我们给出被测类的代码，是一个Servlet：
public class SampleServlet extends HttpServlet {
public void doGet(HttpServletRequest theRequest,
HttpServletResponse theResponse) throws IOException {
PrintWriter pw = theResponse.getWriter();
theResponse.setContentType("text/html");
pw.print("<html><head/><body>");
pw.print("A GET request");
pw.print("</body></html>");
}
public String checkMethod(HttpServletRequest theRequest) {
return theRequest.getMethod();
}
}
Cactus中的测试类框架已经在上面给出。下面来看一下例子，例子是从中Cactus自带的实例中抽取的一部分，如下：
public class TestSampleServlet extends ServletTestCase {
public void testReadServletOutputStream() throws IOException {
SampleServlet servlet = new SampleServlet();
servlet.doGet(request, response);
}
public void endReadServletOutputStream(WebResponse theResponse)
throws IOException {
String expected = "<html><head/><body>A GET request</body></html>";
String result = theResponse.getText();
assertEquals(expected, result);
}
public void beginPostMethod(WebRequest theRequest) {
theRequest.addParameter("param", "value", WebRequest.POST_METHOD);
}
public void testPostMethod() {
SampleServlet servlet = new SampleServlet();
assertEquals("POST", servlet.checkMethod(request));
assertEquals("value", request.getParameter("param"));
}
}
第一个方法testReadServletOutputStream，调用doGet，相当于在客户端提交请求，然后在Servlet处理后会产生一个回馈，所以，在endReadServletOutputStream方法里，我们通过调用response的相应方法判断回馈是否符合预期结果。
第二个方法testPostMethod，在这之前有一个beginPostMethod，在这个方法里我们以POST方式往request里增加一个表单数据param，值为”value”。下面在testPostMethod我们就要验证表单数据是否以POST方式提交到了服务端的Servlet里，所以，我们看到了两个assertEquals，分别进行了判断。在这里我们要注意到beginPostMethod方法中的theRequest和testPostMethod中的request的区别，在前面我们已经提到过，beginPostMethod是在客户端执行的，所以它方法内的所有操作事实上是模拟页面操作的，比如上面的设置表单数据，而testPostMethod是服务端执行的，其中的request也是服务端的。
配置cactus.properties和web.xmlcactus.properties
- cactus.contextURL
这个属性是必须的，它指定了web应用的访问地址
例：cactus.contextURL = http://localhost:8080/test
- cactus.servletRedirectorName
可选，当测试类继承ServletTestCase时用于指定Cactus Servlet Redirector的映射名称。默认：ServletRedirector
例：cactus.servletRedirectorName = ServletRedirector
- cactus.jspRedirectorName
可选，当测试类继承ServletTestCase时用于指定Cactus Jsp Redirector的映射名称。默认：ServletRedirector
例：cactus.jspRedirectorName = JspRedirector
- cactus.filterRedirectorName (For J2EE API 1.3 only)
可选，当测试类继承ServletTestCase时用于指定Cactus Filter Redirector的映射名称。默认：ServletRedirector
例：cactus.filterRedirectorName = FilterRedirector
Cactus.properties你可以放置在WEB-INF/classes/下。
web.xml
在web.xml里要为相应的测试类指定相应的Cactus Redirector。
ServletTestCase对应org.apache.cactus.server.ServletTestRedirector
JspTestCase对应/jspRedirector.jsp
FilterTestCase对应org.apache.cactus.server.FilterTestRedirector
<web-app>
<filter>
<filter-name>FilterRedirector</filter-name>
<filter-class>org.apache.cactus.server.FilterTestRedirector</filter-class>
</filter>
<filter-mapping>
<filter-name>FilterRedirector</filter-name>
<url-pattern>/FilterRedirector</url-pattern>
</filter-mapping>
<servlet>
<servlet-name>ServletRedirector</servlet-name>
<servlet-class>org.apache.cactus.server.ServletTestRedirector</servlet-class>
</servlet>
<servlet>
<servlet-name>JspRedirector</servlet-name>
<jsp-file>/jspRedirector.jsp</jsp-file>
</servlet>
<servlet-mapping>
<servlet-name>ServletRedirector</servlet-name>
<url-pattern>/ServletRedirector</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>JspRedirector</servlet-name>
<url-pattern>/JspRedirector</url-pattern>
</servlet-mapping>
</web-app>
如果你的测试类继承了JspTestCase则需要将jspRedirector.jsp文件放置到你在web.xml中指定的路径里。
安装说明
- 在使用Cactus时，strutstest.jar还需要有下列包的支持。包可放置在WEB-INF/lib下
如下：
- Client端，需要如下包
junit.jar
servlet.jar
cactus.jar
httpclient.jar
commons-logging.jar
httpunit.jar，Tidy.jar，xerces.jar（可选，如果你集成了httpunit的话就需要，也就是在endXXX中使用了httpunit）
- Server端（也就是web容器）需要如下包
cactus.jar
junit.jar
aspectjrt.jar
commons-logging.jar
- 写好测试代码后将class放置在WEB-INF/classes下
- 被测代码也放置在WEB-INF/classes下
- 写好cactus.properties和web.xml两个配置文件
- 启动web容器
- 运行测试代码