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容器 运行测试代码
文章来源于领测软件测试网 https://www.ltesting.net/