posts - 14,  comments - 37,  trackbacks - 0

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

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

可选,当测试类继承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下

如下:

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容器
  • 运行测试代码

结束

posted on 2007-07-10 10:15 冰封的爱 阅读(107) 评论(0)  编辑  收藏 所属分类: J2EE

只有注册用户登录后才能发表评论。


网站导航:
 
<2024年12月>
24252627282930
1234567
891011121314
15161718192021
22232425262728
2930311234

常用链接

留言簿(3)

随笔档案

文章分类

文章档案

相册

搜索

  •  

最新评论

阅读排行榜

评论排行榜