HttpUnit集成测试

HttpUnit是一个集成测试工具，主要关注Web应用的测试，提供的帮助类让测试者可以通过Java类和服务器进行交互，并且将服务器端的响应当作文本或者DOM对象进行处理。HttpUnit还提供了一个模拟Servlet容器，让你可以不需要发布Servlet，就可以对Servlet的内部代码进行测试。本文中作者将详细的介绍如何使用HttpUnit提供的类完成集成测试。

1. 如何使用httpunit处理页面的内容

• WebConversation类是HttpUnit框架中最重要的类，它用于模拟浏览器的行为
• WebRequest类，模仿客户请求，通过它可以向服务器发送信息
• WebResponse类，模拟浏览器获取服务器端的响应信息

1.1 获取指定页面的内容
   1.1.1 直接获取页面内容

java 代码

System.out.println("直接获取网页内容：");
//建立一个WebConversation实例
WebConversation wc = new WebConversation();
//向指定的URL发出请求，获取响应
WebResponse wr = wc.getResponse( "http://localhost:6888/HelloWorld.html" );
//用getText方法获取相应的全部内容
//用System.out.println将获取的内容打印在控制台上
System.out.println( wr.getText() );

 1.1.2 通过Get方法访问页面并且加入参数

java 代码

System.out.println("向服务器发送数据，然后获取网页内容：");
//建立一个WebConversation实例
WebConversation wc = new WebConversation();
//向指定的URL发出请求
WebRequest req = new GetMethodWebRequest( "http://localhost:6888/HelloWorld.jsp" );
//给请求加上参数
req.setParameter("username","姓名");
//获取响应对象
WebResponse resp = wc.getResponse( req );
//用getText方法获取相应的全部内容
//用System.out.println将获取的内容打印在控制台上
System.out.println( resp.getText() );

1.1.3 通过Post方法访问页面并且加入参数

java 代码

System.out.println("使用Post方式向服务器发送数据，然后获取网页内容：");
//建立一个WebConversation实例
WebConversation wc = new WebConversation();
//向指定的URL发出请求
WebRequest req = new PostMethodWebRequest( "http://localhost:6888/HelloWorld.jsp" );
//给请求加上参数
req.setParameter("username","姓名");
//获取响应对象
WebResponse resp = wc.getResponse( req );

//用getText方法获取相应的全部内容
//用System.out.println将获取的内容打印在控制台上
System.out.println( resp.getText() );

大家关注一下上面代码中打了下划线的两处内容，应该可以看到，使用Get、Post方法访问页面的区别就是使用的请求对象不同。

1.2 处理页面中的链接
这里的演示是找到页面中的某一个链接，然后模拟用户的单机行为，获得它指向文件的内容。比如在我的页面HelloWorld.html中有一个链接，它显示的内容是TestLink，它指向我另一个页面TestLink.htm. TestLink.htm里面只显示TestLink.html几个字符。
下面是处理代码：

java 代码

System.out.println("获取页面中链接指向页面的内容：");
//建立一个WebConversation实例
WebConversation wc = new WebConversation();
//获取响应对象
WebResponse resp = wc.getResponse( "http://localhost:6888/HelloWorld.html" );
//获得页面链接对象
WebLink link = resp.getLinkWith( "TestLink" );
//模拟用户单击事件
link.click();
//获得当前的响应对象
WebResponse  nextLink = wc.getCurrentPage();

//用getText方法获取相应的全部内容
//用System.out.println将获取的内容打印在控制台上
System.out.println( nextLink.getText() );

1.3 处理页面中的表格
表格是用来控制页面显示的常规对象，在HttpUnit中使用数组来处理页面中的多个表格，你可以用resp.getTables()方法获取页面所有的表格对象。他们依照出现在页面中的顺序保存在一个数组里面。

[注意] Java中数组下标是从0开始的，所以取第一个表格应该是resp.getTables()[0]，其他以此类推。

下面的例子演示如何从页面中取出第一个表格的内容并且将他们循环显示出来：

java 代码

System.out.println("获取页面中表格的内容;");
//建立一个WebConversation实例
WebConversation wc = new WebConversation();
//获取响应对象
WebResponse   resp = wc.getResponse( "http://localhost:6888/HelloWorld.html" );
//获得对应的表格对象
WebTable webTable = resp.getTables()[0];
//将表格对象的内容传递给字符串数组
String[][] datas = webTable.asText();
//循环显示表格内容
int i = 0 ,j = 0;
int m = datas[0].length;
int n = datas.length;
while (i
  j=0;
  while(j
    System.out.println("表格中第"+(i+1)+"行第"+
 (j+1)+"列的内容是："+datas[i][j]);
    ++j;
  }
  ++i;
}

1.4 处理页面中的表单
表单是用来接受用户输入，也可以向用户显示用户已输入信息（如需要用户修改数据时，通常会显示他以前输入过的信息），在HttpUnit中使用数组来处理页面中的多个表单，你可以用resp.getForms()方法获取页面所有的表单对象。他们依照出现在页面中的顺序保存在一个数组里面。

[注意] Java中数组下标是从0开始的，所以取第一个表单应该是resp.getForms()[0]，其他以此类推。

下面的例子演示如何从页面中取出第一个表单的内容并且将他们循环显示出来：

java 代码

System.out.println("获取页面中表单的内容：");
//建立一个WebConversation实例
WebConversation wc = new WebConversation();
//获取响应对象
WebResponse resp = wc.getResponse( "http://localhost:6888/HelloWorld.html" );
//获得对应的表单对象
WebForm webForm = resp.getForms()[0];
//获得表单中所有控件的名字
String[] pNames = webForm.getParameterNames();
int i = 0;
int m = pNames.length;
//循环显示表单中所有控件的内容
while(i
   System.out.println("第"+(i+1)+"个控件的名字是"+pNames[i]+
   "，里面的内容是"+webForm.getParameterValue(pNames[i]));
   ++i;
}

2. 如何使用httpunit进行测试
2.1 对页面内容进行测试
httpunit中的这部分测试完全采用了JUnit的测试方法，即直接将你期望的结果和页面中的输出内容进行比较。不过这里的测试就简单多了，只是字符串和字符串的比较。

比如你期望中的页面显示是中有一个表格，它是页面中的第一个表格，而且他的第一行第一列的数据应该是显示username，那么你可以使用下面的代码进行自动化测试：

java 代码

System.out.println("获取页面中表格的内容并且进行测试：");
//建立一个WebConversation实例
WebConversation wc = new WebConversation();
//获取响应对象
WebResponse resp = wc.getResponse( "http://localhost:6888/TableTest.html" );
//获得对应的表格对象
WebTable webTable = resp.getTables()[0];
//将表格对象的内容传递给字符串数组
String[][] datas = webTable.asText();
//对表格内容进行测试
String expect = "中文";
Assert.assertEquals(expect,datas[0][0]);

2.2 对Servlet进行测试
除了对页面内容进行测试外，有时候（比如开发复杂的Servlets的时候），你需要对Servlet本身的代码块进行测试，这时候你可以选择HttpUnit，它可以提供一个模拟的Servlet容器，让你的Servlet代码不需要发布到Servlet容器（如tomcat）就可以直接测试。

2.2.1 原理简介
使用httpunit测试Servlet时，请创建一个ServletRunner的实例，他负责模拟Servlet容器环境。如果你只是测试一个Servlet,你可以直接使用registerServlet方法注册这个Servlet，如果需要配置多个Servlet，你可以编写自己的web.xml，然后在初始化ServletRunner的时候将它的位置作为参数传给ServletRunner的构造器。

在测试Servlet时，应该记得使用ServletUnitClient类作为客户端，他和前面用过的WebConversation差不多，都继承自WebClient，所以他们的调用方式基本一致。要注意的差别是，在使用ServletUnitClient时，他会忽略URL中的主机地址信息，而是直接指向他的ServletRunner实现的模拟环境。

2.2.2 简单测试
本实例只是演示如何简单的访问Servlet并且获取他的输出信息，例子中的Servlet在接到用户请求的时候只是返回一串简单的字符串：Hello World!.

1. Servlet的代码如下：

java 代码

package janier.servlet;

import java.io.IOException;
import java.io.PrintWriter;

import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

/**
 * @author Janier
 *
 */
public class HelloWorld extends HttpServlet {
     /**
     *
     */
    private static final long serialVersionUID = 7242188527423883719L;

    public void service(HttpServletRequest req, HttpServletResponse resp)
     throws IOException
     {
      PrintWriter out = resp.getWriter();
      //向浏览器中写一个字符串Hello World!
      out.println("Hello World!");
      out.close();
     }
}

 2. 测试的调用代码如下：

java 代码

package test.servlet;

import janier.servlet.HelloWorld;

import com.meterware.httpunit.GetMethodWebRequest;
import com.meterware.httpunit.WebRequest;
import com.meterware.httpunit.WebResponse;
import com.meterware.servletunit.ServletRunner;
import com.meterware.servletunit.ServletUnitClient;

import junit.framework.TestCase;

/**
 * @author Janier
 *
 */
public class HttpUnitTestHelloWorld extends TestCase{

    protected void setUp() throws Exception {
          super.setUp();
         }

         protected void tearDown() throws Exception {
          super.tearDown();
         }

         public void testHelloWorld() {

          try {
              //创建Servlet的运行环境
              ServletRunner sr = new ServletRunner();
              //向环境中注册Servlet
              sr.registerServlet( "HelloWorld", HelloWorld.class.getName() );
              //创建访问Servlet的客户端
              ServletUnitClient sc = sr.newClient();
              //发送请求
              WebRequest request = new GetMethodWebRequest( "http://localhost/HelloWorld" );
              //获得模拟服务器的信息
              WebResponse response = sc.getResponse( request );
              //将获得的结果打印到控制台上
              System.out.println(response.getText());
          } catch (Exception e) {
           e.printStackTrace();
           }
          }
}

2.2 测试Servlet的内部行为
下面的代码演示了如何使用HttpUnit模拟Servlet容器，并且通过InvocationContext对象，测试Servlet内部行为的大部分工作，比如控制request、session、response等。

1.测试代码

java 代码

package test.servlet;

import janier.servlet.HelloWorld;

import com.meterware.httpunit.GetMethodWebRequest;
import com.meterware.httpunit.WebRequest;
import com.meterware.httpunit.WebResponse;
import com.meterware.servletunit.InvocationContext;
import com.meterware.servletunit.ServletRunner;
import com.meterware.servletunit.ServletUnitClient;

import junit.framework.Assert;
import junit.framework.TestCase;

/**
 * @author Janier
 *
 */
public class HttpUnitTestHelloWorld extends TestCase{

    protected void setUp() throws Exception {
          super.setUp();
         }

         protected void tearDown() throws Exception {
          super.tearDown();
         }

         public void testHelloWorld() {

          try {
              // 创建Servlet的运行环境
              ServletRunner sr = new ServletRunner();
              //向环境中注册Servlet
              sr.registerServlet( "HelloWorld", HelloWorld.class.getName() );
              //创建访问Servlet的客户端
              ServletUnitClient sc = sr.newClient();
              //发送请求
              WebRequest request = new GetMethodWebRequest( "http://localhost/HelloWorld" );
              request.setParameter("username","testuser");
              //获得该请求的上下文环境
              InvocationContext ic = sc.newInvocation( request );
              //调用Servlet的非服务方法
              HelloWorld is = (HelloWorld)ic.getServlet();
              //测试servlet的某个方法
               Assert.assertTrue(is.authenticate());
              //直接通过上下文获得request对象
              System.out.println("request中获取的内容："+ic.getRequest().getParameter("username"));
              //直接通过上下文获得response对象,并且向客户端输出信息
              ic.getResponse().getWriter().write("haha");
              //直接通过上下文获得session对象，控制session对象,给session赋值
              ic.getRequest().getSession().setAttribute("username","timeson");
              //获取session的值
              System.out.println("session中的值："+ic.getRequest().getSession().getAttribute("username"));
              //使用客户端获取返回信息，并且打印出来
              WebResponse response = ic.getServletResponse();
              System.out.println(response.getText());
          } catch (Exception e) {
           e.printStackTrace();
           }
          }
}

2.调用代码

java 代码

package janier.servlet;

import java.io.IOException;

import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

/**
 * @author Janier
 *
 */
public class HelloWorld extends HttpServlet {
public void saveToSession(HttpServletRequest request) {
        request.getSession().setAttribute("testAttribute",request.getParameter("testparam"));
        }
    public void doGet(HttpServletRequest request,
        HttpServletResponse response) throws IOException{
        String username=request.getParameter("username");
        response.getWriter().write(username+":Hello World!");
        }
    public boolean authenticate(){
       return true;
       }
}

对于开发者来说，仅仅测试请求和返回信息是不够的，所以HttpUnit提供的ServletRunner模拟器可以让你对被调用Servlet内部的行为进行测试。和简单测试中不同，这里使用了InvocationContext获得该Servlet的环境，然后你可以通过InvocationContext对象针对request、response等对象或者是该Servlet的内部行为（非服务方法）进行操作。

上述例子其实是junit的一个测试例子，在其中使用了httpunit模拟的servlet环境,使用上述方法测试servlet可以脱离容器，容易把该测试写入ant或maven脚本，让测试进行。httpunit网址：http://httpunit.sourceforge.net/
使用该种方法测试的弱点就是：如果要使用request(response)的setCharercterEncoding方法时，测试会出现一些问题,而且httpunit在测试servlet行为时，采用的是完全模拟浏览器，有时测试比较难写。

[注意]在测试Servlet的之前，你必须通过InvocationContext完成Servlet中的service方法中完成的工作，因为通过newInvocation方法获取InvocationContext实例的时候该方法并没有被调用。

3. Httpunit测试小总结

1. 模拟用户行为向服务器发送请求，传递参数
2. 模拟用户接受服务器的响应信息，并且通过辅助类分析这些响应信息，结合JUnit框架进行测试
3. 使用HttpUnit提供的模拟Servler容器,测试开发中的Servlet的内部行为

Mock objects方法的最大优点就是，执行测试时不需要运行的容器。可以很快就建立起测试，而且测试运行速度也很快用mock objects来对J2EE组件进行单元测试的缺点是：

• 它们没有测试容器和组件的交互;
• 它们没有测试组件的部署部分;
•  需要熟悉被调用的API，这样才能模拟它，而这个要求可能太高了（尤其对于外部库而言）;
• 无法让你确信代码会在目标容器中正常运行