`

Cactus实例讲解

ServletWebjunitJSPApache 
阅读更多

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

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

 

分享到：
| flex和java的通信
评论
发表评论

您还没有登录,请您登录后再发表评论

相关推荐

Magicbox
Global site tag (gtag.js) - Google Analytics