利用StrutsTestCase测试Struts应用程序



作者:叶枫(http://blog.matrix.org.cn/page/叶枫)
原文:[http://www.matrix.org.cn/resource/article/44/44008_StrutsTestCase.html]http://www.matrix.org.cn/resource/article/44/44008_StrutsTestCase.html[/url]
关键字:Struts StrutsTestCase


一、Struts测试概述
  
  一个具有良好系统架构的J2EE应用程序至少有三层组成,即表现层,商业层和系统
集成层(包括数据存取以及和其他系统集成),目前,Struts是应用比较广泛,实现MVC2模式应用于表现层的一种技术. 在这里面,Struts Action主要用来完成一些简单的数据校验,转换,以及流程转发控制(注意:这里流程不是业务规则). 因此在对整个应用程序进行测试时,我们同时也要测试Struts Action.

  但是,测试Struts Action相对测试简单的JavaBean是比较困难,因为Struts是运行在Web服务器中, 因此要测试Struts Action就必须发布应用程序然后才能测试. 我们想象一下,对于一个拥有上千个JSP page和数百甚至数千Java Classes的大规模应用程序,要把他们发布到诸如Weblogic之类的应用服务器再测试,需要多少的时间和硬件资源? 所以这种模式的测试是非常费时费力的.

  所以,如果有一种办法能够不用发布应用程序,不需要Web服务器就能象测试普通Java Class一样测试Struts Action,那就能极大地加强Struts的可测试性能,使应用程序测试更为容易,简单快速. 现在这个工具来了,这就是StrutsTestCase.


二、StrutsTestCase 概述

  StrutsTestCase 是一个功能强大且容易使用的Struts Action开源测试工具,
它本身就是在大名鼎鼎的JUnit基础上发展起来的。因此通过和JUnit结合
使用能极大加强应用程序的测试并加快应用程序的开发.
  
  StrutsTestCase提供了两者测试方式,模仿方式和容器测试方式. 所谓模仿方式就是有StrutsTestCase本身来模拟Web服务器. 而容器测试方式则需要Web服务器. 本文要讨论的是前者,原因很简单，不需要Web服务器就能象测试普通的Java Class一样测试Struts Action.


三、准备StrutsTestCase和Struts Action/ActionForm/Config

  StrutsTestCase是一个开源工具,可以到http://strutstestcase.sourceforge.net下载. 目前最新版本是2.1.3,
如果你使用Servlet2.3就下载StrutsTestCase213-2.3.jar,使用Servlet2.4的就下载StrutsTestCase213-2.4.jar.
另外StrutsTestCase本身就是从JUnit继承的,所以你还需要下载JUnit3.8.1.

  在本文中,我们用一个简单的例子来做测试. 假设我们有一张表Hotline(country varchar2(50),pno varchar2(50)),
我们要做的是根据输入条件从这张表检索相应的记录.检索条件是country.

Value Object:  

package sample;      
      public class HotlineDTO implements Serializable{
        private String country = "";
       private String pno = "";        
        /**
         * Method HotlineActionForm
         *
         *
         */
        public HotlineDTO () {
             super();
      }

        
        public void setCountry(String country) {
                this.country = country; 
        }

        public void setPno(String pno) {
                this.pno = pno; 
        }

        public String getCountry() {
                return (this.country); 
        }

        public String getPno() {
                return (this.pno); 
        }        
      }

ActionForm:
      

package sample;
      import org.apache.struts.action.ActionForm;
      public class HotlineActionForm extends ActionForm{
        private String country = "";
        private String pno = "";        
        /**
         * Method HotlineActionForm
         *
         *
         */
        public HotlineActionForm() {
                super();
        }

        
        public void setCountry(String country) {
                this.country = country; 
        }

        public void setPno(String pno) {
                this.pno = pno; 
        }

        public String getCountry() {
                return (this.country); 
        }

        public String getPno() {
                return (this.pno); 
        }        
      }
  

Action Class:

     public class SearchHotlineAction extends Action {
     public ActionForward execute(ActionMapping mapping, ActionForm form, HttpServletRequest request,
      HttpServletResponse response) throws Exception {
        String target = "";
        try{
         //调用HotlineDAO检索hotline
         String country=((HotlineActionForm)form).getCountry();
         List hotlineList = HotlineDAO.getHotlineList(country);
         if(hotlineList!=null && hotlineList.size()>0){
            request.setAttribute("hotlineList",hotlineList);
            target = "hotlineList";
         }else{
            target = "notfound";
         }
        }catch(Exception ex){
           ....
        }
                
        
     }

Struts Config:
  

<struts-config>
   
   <form-beans>
     <form-bean name="hotlineActionForm" type="sample.HotlineActionForm" />
       .......
   </form-beans>
  <action-mappings>
     <action path="/SearchHotline"
           name="hotlineActionForm"
           type="sample.SearchHotlineAction "
                     scope="request"                                   
                   validate="false"> 
      <forward name="hotlineList" path="/hotlineList.jsp"/>        
      <forward name="notfound" path="/searchHotline.jsp"/>
   </action>
    .....
  <action-mappings>
   ........
 <struts-config>

四、初试StrutsTestCase

    当采用模拟方式时,所有的StrutsTestCase测试Class都是从MockStrutsTestCase继承下来的.
    下面我们就创建一个最简单的测试Class.
    

public class SearchHotlineAction extends MockStrutsTestCase {

     public void setUp()throws Exception{
     }

     public void tearDown()throws Exception{
     }

    public void testSearchHotline() throws Exception{
    setRequestPathInfo("/SearchHotline.do");
    addRequestParameter("country", "CN");
    actionPerform();
    }
    }

   上面的Class相信用过JUnit的朋友都很熟悉.
    好了,一个简单的测试例子就完成了,如果你用的是Eclipse就选择Run-Run...-JUnit-New就可以直接运行.不需要发布你的程序,不需要任何的Web服务器支持,就可以测试Struts Action,这就是StrutsTestCase带来的好处.下面简单地介绍一下它是怎么工作的.

    在上面的例子中,我们调用setRequestPathInfo()告诉StrutsTestCase我们要模拟JSP调用SearchHotline.do这个Action,并且调用addRequestParameter()增加了一个参数country.最后调用actionPerform()运行.

看到这里,大家发现一个问题没有? 在上面Action的源代码里我们是通过

String country=((HotlineActionForm)form).getCountry();

也就是ActionForm来取得输入的参数值,可我们在testSearchHotline()方法里并没有设置ActionForm?

那么它是怎么出来的呢? 其实大家如果熟悉Struts的运行流程的话就知道,JSP接受用户的输入并发请求时
都是类似这样的http://hostname/servletName?param1=value1&param2=value2. 只是Struts接受到这些
参数后再根据Struts Config里的Action和ActionForm的映射把他们转为ActionForm后传给Action的.

   在上面的例子,我们只是简单地运行了Action,那么Action是否正确执行以及返回的结果是不是我们想要的呢?

我们继续完善一下testSearchHotline()这个Method.

public void testSearchHotline() throws Exception{
    setRequestPathInfo("/SearchHotline.do");
    addRequestParameter("country", "CN");
    actionPerform();
    verifyNoActionErrors();
    verifyForward("hotlineList");
    assertNotNull(request.getAttribute("hotlineList"));
    List hotlineList = (List) request.getAttribute("hotlineList");
    for (Iterator it = hotlineList.iterator();it.hasNext();){
     ....
    }
    }

我们在actionPerform()后增加了几行语句来断定Struts Action是否正确执行.
   verifyNoActionErrors() -- 判断Action里没有任何的Action;
   verifyForward("hotlineList") -- 判断Action确实转发到hotlineList;      
   assertNotNull(request.getAttribute("hotlineList")) -- 判断Action确实返回了hotlineList并且不为空

到这里,我们已经基本上讨论完了StrutsTestCase的核心部分. 从头到尾,我们没有发布应用程序,也不需要Web服务器,对我们来讲,Struts Action就象普通的Java Class一样容易调试测试.这就是StrutsTestCase给我们带来的方便.

五、深入StrutsTestCase

  除了以上我们用到的几个断定和校验方法外,StrutsTestCase还提供了其他几个方法便于我们测试Struts Action. 下面我一一讲述,具体的大家可以参考文档.

verifyActionErrors/Messages --  校验ActionActionServlet controller 是否发送了ActionError或ActionMessage.   参数为ActionError/Message Key
verifyNoActionErrors/Messages --校验ActionActionServlet controller 没有发送ActionError或ActionMessage
VerifyForward -- 校验Action是否正确转发到指定的ActionForward.
VerifyForwardPath -- 校验Action是否正确转发到指定的URL
verifyInputForward -- 校验Action是否转发到Action Mapping里的input属性
verifyTilesForward/verifyInputTilesForward--和以上类似,应用程序使用到tiles时用的

六、关于Web.xml和Struts-Config.xml

  缺省情况下,StrutsTestCase认为你的Web.xml和struts-config.xml的路径分别是:
  /WEB-INF/web.xml和/WEB-INF/struts-config.xml

  1. 假如你的web.xml/struts-config.xml的路径是
  d:/app/web/WEB-INF/web.xml(struts-config.xml)的话,就需要把d:/app/web加到classpath.
  
  2. 假如你的struts config是strust-config-module.xml,
  那么必须调用setConfigFile()设置你的struts config文件
  

七、结束语
  J2EE应用程序的测试在开发过程中占有相当重要的位置,利用StrutsTestCase能极大方便你测试基于Struts的应用程序.