HttpUnit基础教程Web测试工具.doc

TIB自动化测试工作室/testware/HttpUnit简介主页：/HttpUnit是SourceForge下面的一个开源项目，它是基于JUnit的一个测试框架，主要关注于测试Web应用，解决使用JUnit框架无法对远程Web内容进行测试的弊端。HttpUnit让测试者可以通过Java类和服务器进行交互，并且将服务器端的响应当作文本或者DOM对象进行处理。HttpUnit还提供了一个模拟Servlet容器，让你可以不需要发布Servlet，就可以对Servlet的内部代码进行测试。为了让HtpUnit正常运行，需要安装JDK1.3.1或者以上版本。Automated testing is a great way to ensure that code being maintained works. The Extreme Programming (XP) methodology relies heavily on it, and practitioners have available to them a range of testing frameworks, most of which work by making direct calls to the code being tested. But what if you want to test a web application? Or what if you simply want to use a web-site as part of a distributed application?In either case, you need to be able to bypass the browser and access your site from a program. HttpUnit makes this easy. Written in Java, HttpUnit emulates the relevant portions of browser behavior, including form submission, JavaScript, basic http authentication, cookies and automatic page redirection, and allows Java test code to examine returned pages either as text, an XML DOM, or containers of forms, tables, and links. When combined with a framework such as JUnit, it is fairly easy to write tests that very quickly verify the functioning of a web site.The same techniques used to test web sites can be used to test and develop servlets without a servlet container using ServletUnit, included in the download.HTTPUnit的工作原理：HttpUnit通过模拟浏览器的行为，处理页面框架（frames）,cookies,页面跳转（redirects）等。通过HttpUnit提供的功能，你可以和服务器端进行信息交互，将返回的网页内容作为普通文本、XML DOM对象或者是作为链接、页面框架、图像、表单、表格等的集合进行处理。可以结合使用JUnit框架进行测试。还可以导向一个新的页面，然后进行新页面的处理，这个功能使你可以处理一组在一个操作链中的页面。WebConversation类模拟浏览器与网站服务器进行交互WebRequest类发送请求WebResponse类接收响应getTextgetURLgetTablesgetLinks、getLinkWithgetForms可以测试：1、测试某个指定的页面是否存在2、测试页面跳转是否正确3、测试页面内容是否正确4、测试链接5、测试表单HTTPUnit和其他商业工具的对比：商业工具一般使用记录、回放的功能来实现测试，但是这里有个缺陷，就是当页面设计被修改以后，这些被记录的行为就不能重用了，需要重新录制才能继续测试。 举个例子：如果页面上有个元素最先的设计是采用单选框，这个时候你开始测试，那么这些工具记录的就是你的单项选择动作，但是如果你的设计发生了变化，比如说我改成了下拉选择，或者使用文本框接受用户输入，这时候，你以前录制的测试过程就无效了，必须要重新录制。 而HttpUnit因为关注点是这些控件的内容，所以不管你的外在表现形式如何变化，都不影响你已确定测试的可重用性。目前最新版本：20 May 2008HttpUnit 1.7 released下载并解压HttpUnit之后，目录结构应该如下所示：httpunit +- jars /包含创建、测试以及运行HttpUnit所必须的jar | +- lib / 包含HttpUnit jar | +- doc /文档 | | | +- tutorial /基于servlet web网站的测试优先开发的简单教程 | | | +- api / javadoc | | | +- manual / 用户手册 | +- examples / 采用HttpUnit编写的一些示例程序 | +- src / HttpUnit 源代码 | +- test / HttpUnit单元测试的一些很好的例子只有lib和jars两个目录对运行HttpUnit是必须的。至少你必须将HttpUnit jar添加到系统的classpath，而其他的一些jar均为可选。HttpUnit包括许多可选的功能。如果你并不需要这些功能，则不必在classpath中包含相应的库但至少你必须有一个HTML解析器（JTidy和NekoHTML都可被支持）和一个与jaxp兼容的解析器（在发行版中包含了xerces 2.2）。Jar名称所需关系相关文档nekohtml.jarHTML解析器即使是再糟糕的HTML也可适用。需要xerces-j 2.2 或更高版本/andyc/neko/doc/html/index.html.tidy.jar要求苛刻的HTML解析器。可与任何兼容jaxp解析器配合使用/sami/jtidy/xmlParserAPIs.jar支持xerces-j的通用解析APIxercesImpl.jarxerces-j 2.2可执行单元js.jar支持/rhinoservlet.jarservlet单元测试工具ServletUnit 所必须的Jjunit.jar运行单元测试mail.jar测试文件的上传功能（运行HttpUnit本身并不需要）J/products/javamail/activation.jar测试文件的上传功能（运行HttpUnit本身并不需要）J/products/javabeans/glasgow/jaf.html直接获取页面内容The very first step in any interaction with a web site is to obtain a start page. To do this, we create a WebConversation object to play the role of the web browser. This object will store browser state such a cookies, windows, and so on. We then ask for the page by specifying the desired URL:WebConversation wc = new WebConversation();WebResponse wr = wc.getResponse( );System.out.println( wr.getText() );This example will simply print out the text of the retrieved page. Obviously, given this text, it is easy to search for particular strings on the page, if that is desired.在Eclipse中使用HttpUnit：import java.io.IOException;import org.xml.sax.SAXException;import com.meterware.httpunit.*;public class Test /* * param args */public static void main(String args) WebConversation wc = new WebConversation();WebResponse wr = null;try wr = wc.getResponse( :1080/WebTours/ );System.out.println( wr.getText() ); catch (IOException e) e.printStackTrace(); catch (SAXException e) e.printStackTrace();通过Get方法访问页面并且加入参数 例：System.out.println(向服务器发送数据，然后获取网页内容：); /建立一个WebConversation实例 WebConversation wc = new WebConversation(); /向指定的URL发出请求 WebRequest req = new GetMethodWebRequest( :1080/WebTours/nav.pl); /给请求加上参数 req.setParameter(in,home);/获取响应对象 WebResponse resp;try resp = wc.getResponse( req );/用getText方法获取相应的全部内容 /用System.out.println将获取的内容打印在控制台上 System.out.println( resp.getText() ); catch (IOException e) e.printStackTrace(); catch (SAXException e) e.printStackTrace();测试WebTours的例子：import java.io.IOException;import org.xml.sax.SAXException;import com.meterware.httpunit.*;public class Test /* * param args */public static void main(String args) WebConversation wc = new WebConversation();WebResponse wr = null;String userSession = ;try wr = wc.getResponse( :1080/WebTours/ );wr = wc.getResponse(:1080/WebTours/header.html);wr = wc.getResponse(:1080/WebTours/welcome.pl?signOff=1);/wr = wc.getResponse(:1080/WebTours/images/hp_logo.png);/wr = wc.getResponse(:1080/WebTours/images/webtours.png);wr = wc.getResponse(:1080/WebTours/nav.pl?in=home);String responseText = wr.getText() ;System.out.println( responseText );String toFind = userSession value=;int LB = responseText.indexOf(toFind) + toFind.length();int RB = responseText.indexOf(,LB);userSession = responseText.substring(LB,RB);System.out.println(userSession value = + userSession); catch (IOException e) e.printStackTrace(); catch (SAXException e) e.printStackTrace();System.out.println(向服务器发送数据，然后获取网页内容：); /建立一个WebConversation实例 /WebConversation wc = new WebConversation(); /向指定的URL发出请求 WebRequest req = new GetMethodWebRequest( :1080/WebTours/login.pl); /给请求加上参数 req.setParameter(userSession,userSession);req.setParameter(username,jojo);req.setParameter(password,bean);req.setParameter(JSFormSubmit,off);req.setParameter(login.x,54);req.setParameter(login.y,13);/获取响应对象 WebResponse resp;try resp = wc.getResponse( req );/用getText方法获取相应的全部内容 /用System.out.println将获取的内容打印在控制台上 System.out.println( resp.getText() ); catch (IOException e) e.printStackTrace(); catch (SAXException e) e.printStackTrace(); 通过Post方法访问页面并且加入参数例：System.out.println(向服务器发送数据，然后获取网页内容：); /建立一个WebConversation实例 /WebConversation wc = new WebConversation(); /向指定的URL发出请求 WebRequest req = new PostMethodWebRequest( :1080/WebTours/login.pl);/给请求加上参数 req.setParameter(userSession,userSession);req.setParameter(username,jojo);req.setParameter(password,bean);req.setParameter(JSFormSubmit,off);req.setParameter(login.x,54);req.setParameter(login.y,13);/获取响应对象 WebResponse resp;try resp = wc.getResponse( req );/用getText方法获取相应的全部内容 /用System.out.println将获取的内容打印在控制台上 System.out.println( resp.getText() ); catch (IOException e) e.printStackTrace(); catch (SAXException e) e.printStackTrace();可以看到，使用Get、Post方法访问页面的区别就是使用的请求对象不同。 注，Get和Post的区别：1HTTP请求格式：在HTTP请求中，第一行必须是一个请求行（request line），用来说明请求类型、要访问的资源以及使用的HTTP版本。紧接着是一个首部（header）小节，用来说明服务器要使用的附加信息。在首部之后是一个空行，再此之后可以添加任意的其他数据称之为主体（body）。2GET与POST区别HTTP定义了与服务器交互的不同方法，最基本的方法是 GET 和 POST.HTTP-GET和HTTP-POST是使用HTTP的标准协议动词，用于编码和传送变量名/变量值对参数，并且使用相关的请求语义。每个HTTP-GET和HTTP-POST都由一系列HTTP请求头组成，这些请求头定义了客户端从服务器请求了什么，而响应则是由一系列HTTP应答头和应答数据组成，如果请求成功则返回应答。HTTP-GET以使用MIME类型application/x-www-form-urlencoded的urlencoded文本的格式传递参数。Urlencoding是一种字符编码，保证被传送的参数由遵循规范的文本组成，例如一个空格的编码是%20。附加参数还能被认为是一个查询字符串。与HTTP-GET类似，HTTP-POST参数也是被URL编码的。然而，变量名/变量值不作为URL的一部分被传送，而是放在实际的HTTP请求消息内部被传送。（1）get是从服务器上获取数据，post是向服务器传送数据。（1） 在客户端，Get方式在通过URL提交数据，数据在URL中可以看到；POST方式，数据放置在HTML HEADER内提交。（2）对于get方式，服务器端用Request.QueryString获取变量的值，对于post方式，服务器端用Request.Form获取提交的数据。（2） GET方式提交的数据最多只能有1024字节，而POST则没有此限制。（3） 安全性问题。正如在（1）中提到，使用 Get 的时候，参数会显示在地址栏上，而 Post 不会。所以，如果这些数据是中文数据而且是非敏感数据，那么使用 get；如果用户输入的数据不是中文字符而且包含敏感数据，那么还是使用 post为好。注：所谓安全的意味着该操作用于获取信息而非修改信息。幂等的意味着对同一 URL 的多个请求应该返回同样的结果。完整的定义并不像看起来那样严格。换句话说，GET 请求一般不应产生副作用。从根本上讲，其目标是当用户打开一个链接时，她可以确信从自身的角度来看没有改变资源。比如，新闻站点的头版不断更新。虽然第二次请求会返回不同的一批新闻，该操作仍然被认为是安全的和幂等的，因为它总是返回当前的新闻。反之亦然。POST 请求就不那么轻松了。POST 表示可能改变服务器上的资源的请求。仍然以新闻站点为例，读者对文章的注解应该通过 POST 请求实现，因为在注解提交之后站点已经不同了（比方说文章下面出现一条注解）。下面举一个简单的例子来说明它们的区别： % If Request.QueryString(Text) Then % 通过get方式传递的字符串是： % If Request.Form(Text) Then % 通过Post方式传递的字符串是： 处理页面中的链接找到页面中的某一个链接，然后模拟用户的单击行为，获得它指向文件的内容。例：public static void Link()System.out.println(获取页面中链接指向页面的内容：); /建立一个WebConversation实例 WebConversation wc = new WebConversation(); /获取响应对象 WebResponse resp;try resp = wc.getResponse( :1080/WebTours/ );resp = wc.getResponse(:1080/WebTours/header.html);resp = wc.getResponse(:1080/WebTours/welcome.pl?signOff=true);resp = wc.getResponse(:1080/WebTours/nav.pl?in=home);resp = wc.getResponse(:1080/WebTours/home.html);/String respText = resp.getText();/System.out.println(respText);/获得页面链接对象 WebLink link = resp.getLinks();String linkURL = link1.getURLString();String linkName = link1.getName();String linkText = link1.getText();String linkID = link1.getID();System.out.println(linkURL:+linkURL +n);System.out.print(linkName:+linkName+n);System.out.print(linkText:+linkText+n);System.out.print(linkID:+linkID+n);/模拟用户单击事件 link0.click(); /获得当前的响应对象 WebResponse nextLink = wc.getCurrentPage(); /用getText方法获取相应的全部内容 /用System.out.println将获取的内容打印在控制台上 System.out.println( nextLink.getText() ); catch (IOException e) e.printStackTrace(); catch (SAXException e) e.printStackTrace(); 处理页面中的表格表格是用来控制页面显示的常规对象，在HttpUnit中使用数组来处理页面中的多个表格，你可以用resp.getTables()方法获取页面所有的表格对象。他们依照出现在页面中的顺序保存在一个数组里面。例：try resp = wc.getResponse( :1080/WebTours/welcome.pl?page=itinerary );resp = wc.getResponse( :1080/WebTours/nav.pl?page=menu&in=itinerary );resp = wc.getResponse( :1080/WebTours/itinerary.pl );/获得对应的表格对象 WebTable webTable = resp.getTables()0;int rowCount = webTable.getRowCount();System.out.println(n表格行数： + rowCount); catch (SAXException e) e.printStackTrace(); catch (IOException e) e.printStackTrace();处理页面中的表单表单是用来接受用户输入，也可以向用户显示用户已输入信息（如需要用户修改数据时，通常会显示他以前输入过的信息），在HttpUnit中使用数组来处理页面中的多个表单，你可以用resp.getForms()方法获取页面所有的表单对象。他们依照出现在页面中的顺序保存在一个数组里面。例：WebRequest reqs = new GetMethodWebRequest( :1080/WebTours/welcome.pl?page=search); reqs = new GetMethodWebRequest( :1080/WebTours/nav.pl?page=menu&in=flights); reqs = new GetMethodWebRequest( :1080/WebTours/reservations.pl?page=welcome); WebResponse resps = null;try resps = wc.getResponse( reqs );System.out.println( resps.getText() ); /获得表单对象WebForm webForms = resps.getForms();/获得表单中所有控件的名字String pNames = webForms0.getParameterNames(); int i = 0; int m = pNames.length; /循环显示表单中所有控件的内容 while(i,LB);userSession = responseText.substring(LB,RB);System.out.println(userSession value = + userSession); catch (IOException e) e.printStackTrace(); catch (SAXException e) e.printStackTrace();WebRequest req = new PostMethodWebRequest( :1080/WebTours/login.pl);req.setParameter(userSession,userSession);req.setParameter(username,jojo);req.setParameter(password,bean);req.setParameter(JSFormSubmit,off);req.setParameter(login.x,54);req.setParameter(login.y,13);WebResponse resp = null;try resp = wc.getResponse( req );System.out.println( resp.getText() ); catch (IOException e) e.printStackTrace(); catch (SAXException e) e.printStackTrace(); try resp = wc.getResponse( :1080/WebTours/welcome.pl?page=itinerary );resp = wc.getResponse( :1080/WebTours/nav.pl?page=menu&in=itinerary );resp = wc.getResponse( :1080/WebTours/itinerary.pl );/获得对应的表格对象 WebTable webTable = resp.getTables()0;int rowCount = webTable.getRowCount();System.out.println(n表格行数： + rowCount);/将表格对象的内容传递给字符串数组 String datas = webTable.asText(); /对表格内容进行测试 String expect = A total of 1 scheduled flights.; assertEquals(expect,datas40.toString(); catch (SAXException e) e.printStackTrace(); catch (IOException e) e.printStackTrace();对Servlet进行测试除了对页面内容进行测试外，有时候（比如开发复杂的Servlets的时候），你需要对Servlet本身的代码块进行测试，这时候你可以选择HttpUnit，它可以提供一个模拟的Servlet容器，让你的Servlet代码不需要发布到Servlet容器（如tomcat）就可以直接测试。使用httpunit测试Servlet时，请创建一个ServletRunner的实例，他负责模拟Servlet容器环境。如果你只是测试一个Servlet,你可以直接使用registerServlet方法注册这个Servlet，如果需要配置多个Servlet，你可以编写自己的web.xml，然后在初始化ServletRunner的时候将它的位置作为参数传给ServletRunner的构造器。在测试Servlet时，应该记得使用ServletUnitClient类作为客户端，他和前面用过的WebConversation差不多，都继承自WebClient，所以他们的调用方式基本一致。要注意的差别是，在使用ServletUnitClient时，他会忽略URL中的主机地址信息，而是直接指向他的ServletRunner实现的模拟环境。简单例子：1、创建被测试的Servlet：import java.io.IOException;import java.io.PrintWriter;import javax.servlet.ServletException;import javax.servlet.http.HttpServlet;import javax.servlet.http.HttpServletRequest;import javax.servlet.http.HttpServletResponse;public class HelloWorldExample extends HttpServlet public void doGet(HttpServletRequest request, HttpServletResponse response) throws IOException, ServletException response.setContentType(text/html); PrintWriter out = response.getWriter(); out.println(); out.println(); String title = helloworld.title; out.println( + title + ); out.println(); out.println();/ note that all links are created to be relative. this/ ensures that we can move the web application that this/ servlet belongs to to a different place in the url/ tree and not have any harmful side effects. / XXX / making these absolute til