Structs2教程(例子)

Struts2教程

 

 

 

在本系列教程中我们将学习到Struts2的各种技术。在本教程中使用的工具和程序库的版本如下:

开发工具:MyEclipse6

Web服务器:Tomcat6

Struts版本:Struts2.0.11.1

JDK版本:JDK1.5.0_12

J2EE版本:Java EE5.0

    在本系列教程中Web工程的上下文路径都是struts2,如果在Web根目录有一个index.jsp文件,则访问路径如下:

http://localhost:8080/struts2/index.jsp

    由于MyEclipse6目前并不支持Struts2,所以我们需要到struts.apache.org去下载Struts2安装包。要想正常使用Struts2,至少需要如下五个包(可能会因为Struts2的版本不同,包名略有差异,但包名的前半部是一样的)。

struts2-core-2.0.11.1.jar

xwork-2.0.4.jar

commons-logging-1.0.4.jar

freemarker-2.3.8.jar

ognl-2.6.11.jar

    Struts2虽然在大版本号上是第二个版本,但基本上在配置和使用上已经完全颠覆了Struts1.x的方式(当然,Struts2仍然是基于MVC模式的,也是动作驱动的,可能这是唯一没变的东西)。Struts2实际上是在Webwork基础上构建起来的MVC框架。我们从Struts2的源代码中可以看到,有很多都是直接使用的xwork(Webwork的核心技术)的包。既然从技术上来说Struts2是全新的框架,那么就让我们来学习一下这个新的框架的使用方法。

    如果大家使用过Struts1.x,应该对建立基于Struts1.xWeb程序的基本步骤非常清楚。让我们先来回顾一下建立基于Struts1.xWeb程序的基本步骤。

1.        安装Struts。由于Struts的入口点是ActionServlet,所以得在web.xml中配置一下这个Servlet

2.        编写Action类(一般从org.apache.struts.action.Action类继承)。

3.        编写ActionForm类(一般从org.apache.struts.action.ActionForm类继承),这一步不是必须的,如果要接收客户端提交的数据,需要执行这一步。

4.        struts-config.xml文件中配置ActionActionForm

5.        如果要采集用户录入的数据,一般需要编写若干JSP页面,并通过这些JSP页面中的form将数据提交给Action

下面我们就按着编写struts1.x程序的这五步和struts2.x程序的编写过程一一对应,看看它们谁更“酷”。下面我们来编写一个基于Struts2Web程序。这个程序的功能是让用户录入两个整数,并提交给一个Struts Action,并计算这两个数的代数和,如果代码和为非负数,则跳转到positive.jsp页面,否则跳转到negative.jsp页面。

 

【第1步】 安装Struts2

    这一步对于Struts1.xStruts2都是必须的,只是安装的方法不同。Struts1的入口点是一个Servlet,而Struts2的入口点是一个过滤器(Filter)。因此,Struts2要按过滤器的方式配置。下面是在web.xml中配置Struts2的代码:

< filter >
    < filter-name > struts2 </ filter-name >
    
< filter-class >
        org.apache.struts2.dispatcher.FilterDispatcher            
    
</ filter-class >
</ filter >
< filter-mapping >
    
< filter-name > struts2 </ filter-name >
    
< url-pattern > /* </ url-pattern >
</ filter-mapping >

 

【第2步】 编写Action

    这一步和 Struts1.x 也必须进行。只是 Struts1.x 中的动作类必须从 Action 类中继承,而 Struts2.x 的动作类需要从 com.opensymphony.xwork2.ActionSupport 类继承。下面是计算两个整数代码和的 Action 类,代码如下:
package  action;
  
import  com.opensymphony.xwork2.ActionSupport;
  
public   class  FirstAction  extends  ActionSupport
{
    
private   int  operand1;
    
private   int  operand2;
  
    
public  String execute()  throws  Exception
    {
        
if  (getSum()  >=   0 )   //  如果代码数和是非负整数,跳到positive.jsp页面
        {
            
return   " positive " ;
        }
        
else    //  如果代码数和是负整数,跳到negative.jsp页面
        {
            
return   " negative " ;
        }
    }
  
    
public   int  getOperand1()
    {
        
return  operand1;
    }
  
    
public   void  setOperand1( int  operand1)
    {
        System.out.println(operand1);
          
this .operand1  =  operand1;
    }
  
    
public   int  getOperand2()
    {
        
return  operand2;
    }  
    
public   void  setOperand2( int  operand2)
    {
        System.out.println(operand2);
        
this .operand2  =  operand2;
    }
    
public   int  getSum()
    {
        
return  operand1  +  operand2;   //  计算两个整数的代码数和
    }
}
 

从上面的代码可以看出,动作类的一个特征就是要覆盖execute方法,只是Struts2execute方法没有参数了,而Struts1.xexecute方法有四个参数。而且execute方法的返回值也不同的。Struts2只返回一个String,用于表述执行结果(就是一个标志)。上面代码的其他部分将在下面讲解。

【第3步】 编写ActionForm

    在本例中当然需要使用ActionForm了。在Struts1.x中,必须要单独建立一个ActionForm类(或是定义一个动作Form),而在Struts2ActionFormAction已经二合一了。从第二步的代码可以看出,后面的部分就是应该写在ActionForm类中的内容。所以在第2步,本例的ActionForm类已经编写完成(就是Action类的后半部分)。

【第4步】 配置Action

    这一步struts1.xstruts2.x都是必须的,只是在struts1.x中的配置文件一般叫struts-config.xml(当然也可以是其他的文件名),而且一般放到WEB-INF目录中。而在struts2.x中的配置文件一般为struts.xml,放到WEB-INF"classes目录中。下面是在struts.xml中配置动作类的代码:

<? xml version="1.0" encoding="UTF-8"  ?>
  
<! DOCTYPE struts PUBLIC
      "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
      "http://struts.apache.org/dtds/struts-2.0.dtd"
>
  
< struts >
      
< package  name ="struts2"  namespace ="/mystruts"
          extends
="struts-default" >
          
< action  name ="sum"  class ="action.FirstAction" >
              
< result  name ="positive" > /positive.jsp </ result >
              
< result  name ="negative" > /negative.jsp </ result >
          
</ action >
      
</ package >
  
</ struts >
 

<struts>标签中可以有多个<package>,第一个<package>可以指定一个Servlet访问路径(不包括动作名),如“/mystruts”。extends属性继承一个默认的配置文件“struts-default”,一般都继承于它,大家可以先不去管它。<action>标签中的name属性表示动作名,class表示动作类名。

    <result>标签的name实际上就是execute方法返回的字符串,如果返回的是“positive”,就跳转到positive.jsp页面,如果是“negative”,就跳转到negative.jsp页面。在<struts>中可以有多个<package>,在<package>中可以有多个<action>。我们可以用如下的URL来访问这个动作:

http://localhost:8080/struts2/mystruts/sum.action

Struts1.x的动作一般都以.do结尾,而Struts2是以.action结尾。

【第5步】 编写用户录入接口(JSP页面)

1.       主界面(sum.jsp

Web根目录建立一个sum.jsp,代码如下:

<% @ page language = " java "  import = " java.util.* "  pageEncoding = " GBK "   %>
  
<% @ taglib prefix = " s "  uri = " /struts-tags " %>
  
  
< html >
      
< head >
          
< title > 输入操作数 </ title >
      
</ head >
  
      
< body >
           求代数和
          
< br />
          
< s:form  action ="mystruts/sum.action"   >                 
              
< s:textfield  name ="operand1"  label =" 操作数1" />
              
< s:textfield  name ="operand2"   label =" 操作数2"   />         
              
< s:submit  value ="代数和"   />             
          
</ s:form >
      
</ body >
  
</ html >
 

sum.jsp中使用了Struts2带的tag。在Struts2中已经将Struts1.x的好几个标签库都统一了,在Struts2中只有一个标签库/struts-tags。这里面包含了所有的Struts2标签。但使用Struts2的标签大家要注意一下。在<s:form>中最好都使用Struts2标签,尽量不要用HTML或普通文本,大家可以将sum.jsp的代码改为如下的形式,看看会出现什么效果:

         ... ...

           求代数和

          <br/>

          <s:form action="mystruts/sum.action" >               

操作数1<s:textfield name="operand1" /><br/>

操作数2<s:textfield name="operand1" /><br/>

              <s:submit value="代数和" />           

          </s:form>

          ... ...

    提示一下,在<s:form>Struts2使用<table>定位。

2.       positive.jsp

<% @ page language = " java "  import = " java.util.* "  pageEncoding = " GBK " %>
  
<% @ taglib prefix = " s "  uri = " /struts-tags "   %>
  
  
< html >
    
< head >
      
< title > 显示代数和 </ title >
    
</ head >
    
    
< body >     
      代数和为非负整数
< h1 >< s:property  value ="sum"   /></ h1 >
    
</ body >
  
</ html >  
 

3.       negative.jsp

  <% @ page language = " java "  import = " java.util.* "  pageEncoding = " GBK " %>
  
<% @ taglib prefix = " s "  uri = " /struts-tags "   %>
  
  
< html >
    
< head >
      
< title > 显示代数和 </ title >
    
</ head >
    
    
< body >
      代数和为负整数
< h1 >< s:property  value ="sum"   /></ h1 >
      
    
</ body >
  
</ html >  

 

    这两个jsp页面的实现代码基本一样,只使用了一个<s:property>标签来显示Action类中的sum属性值。<s:property>标签是从request对象中获得了一个对象中得到的sum属性,如我们可以使用如下的代码来代替<s:property value=”sum”/>

 

<%

 com.opensymphony.xwork2.util.OgnlValueStack ovs =

(com.opensymphony.xwork2.util.OgnlValueStack)request.getAttribute("struts.valueStack"); 

 out.println(ovs.findString("sum")); 

%>

    启动Tomcat后,在IE中输入如下的URL来测试这个例子:

http://localhost:8080/struts2/sum.jsp

 

Struts2教程2:处理一个form多个submit

在很多Web应用中,为了完成不同的工作,一个HTML form标签中可能有两个或多个submit按钮,如下面的代码所示:
<!--[if !supportLineBreakNewLine]-->

< html  action =""   method ="post" >
 
< input  type ="submit"  value ="保存"   />
< input  type ="submit"  value ="打印"   />
</ html >


 

由于在<form>中的多个提交按钮都向一个action提交,使用Struts2 Actionexecute方法就无法判断用户点击了哪一个提交按钮。如果大家使用过Struts1.x就会知道在Struts1.2.9之前的版本需要使用一个LookupDispatchAction动作来处理含有多个submitform。但使用LookupDispatchAction动作需要访问属性文件,还需要映射,比较麻烦。从Struts1.2.9开始,加入了一个EventDispatchAction动作。这个类可以通过java反射来调用通过request参数指定的动作(实际上只是判断某个请求参数是不存在,如果存在,就调用在action类中和这个参数同名的方法)。使用EventDispatchAction必须将submitname属性指定不同的值以区分每个submit。而在Struts2中将更容易实现这个功能。

当然,我们也可以模拟EventDispatchAction的方法通过request获得和处理参数信息。但这样比较麻烦。在Struts2中提供了另外一种方法,使得无需要配置可以在同一个action类中执行不同的方法(默认执行的是execute方法)。使用这种方式也需要通过请求参来来指定要执行的动作。请求参数名的格式为

action!method.action

注:由于Struts2只需要参数名,因此,参数值是什么都可以。

下面我就给出一个实例程序来演示如何处理有多个submitform

【第1步】实现主页面(more_submit.jsp)


 

<% @ page language = " java "  import = " java.util.* "  pageEncoding = " GBK " %>
<% @ taglib prefix = " s "  uri = " /struts-tags "   %>
< html >
  
< head >
    
< title > My JSP 'hello.jsp' starting page </ title >
  
</ head >
  
  
< body >
    
< s:form  action ="submit.action"   >
        
< s:textfield  name ="msg"  label ="输入内容" />   
        
< s:submit  name ="save"  value ="保存"  align ="left"  method ="save" />
        
< s:submit  name ="print"  value ="打印"  align ="left"  method ="print"   />       
    
</ s:form >
  
</ body >
</ html >

more_submit.jsp中有两个submit:保存和打印。其中分别通过method属性指定了要调用的方法:saveprint。因此,在Action类中必须要有saveprint方法。

【第2步】实现Action类(MoreSubmitAction


 

package  action;

import  javax.servlet.http. * ;

import  com.opensymphony.xwork2.ActionSupport;
import  org.apache.struts2.interceptor. * ;

public   class  MoreSubmitAction  extends  ActionSupport  implements  ServletRequestAware
{
    
private  String msg;
    
private  javax.servlet.http.HttpServletRequest request;
    
//  获得HttpServletRequest对象
     public   void  setServletRequest(HttpServletRequest request)
    {
        
this .request  =  request;
    }
    
//  处理save submit按钮的动作
     public  String save()  throws  Exception
    {
        request.setAttribute(
" result " " 成功保存[ "   +  msg  +   " ] " );
        
return   " save " ;
    }

    
//  处理print submit按钮的动作
     public  String print()  throws  Exception
    {
        request.setAttribute(
" result " " 成功打印[ "   +  msg  +   " ] " );
        
return   " print " ;
    }
    
public  String getMsg()
    {
        
return  msg;
    }

    
public   void  setMsg(String msg)
    {
        
this .msg  =  msg;
    }
}

上面的代码需要注意如下两点:

saveprint方法必须存在,否则会抛出java.lang.NoSuchMethodException异常。

Struts2 Action动作中的方法和Struts1.x Actionexecute不同,只使用Struts2 Action动作的execute方法无法访问request对象,因此,Struts2 Action类需要实现一个Struts2自带的拦截器来获得request对象,拦截器如下:

org.apache.struts2.interceptor. ServletRequestAware

【第3步】配置Struts2 Action

struts.xml的代码如下:

<? xml version="1.0" encoding="UTF-8"  ?>
<! DOCTYPE struts PUBLIC
    "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
    "http://struts.apache.org/dtds/struts-2.0.dtd"
>
< struts >     
    
< package  name ="demo"  extends ="struts-default"   >
        
< action  name ="submit"   class ="action.MoreSubmitAction" >
            
< result  name ="save"   >
                /result.jsp
            
</ result >
            
< result  name ="print" >
                /result.jsp
            
</ result >
        
</ action >     
    
</ package >     
</ struts >

【第4步】编写结果页(result.jsp


 

<% @ page pageEncoding = " GBK " %>
< html >
  
< head >
    
< title > 提交结果 </ title >
  
</ head >
  
< body >
    
< h1 > ${result} </ h1 >
  
</ body >
</ html >

result.jsp中将在saveprint方法中写到request属性中的执行结果信息取出来,并输出到客户端。

启动Tomcat后,在IE中执行如下的URL来测试程序:

    http://localhost:8080/moresubmit/more_submit.jsp

大家也可以直接使用如下的URL来调用saveprint方法:

调用save方法:http://localhost:8080/moresubmit/submit!save.action

调用print方法:http://localhost:8080/moresubmit/submit!print.action

源代码:http://www.itpub.net/attachment.php?aid=520773


Struts2教程3:struts.xml常用配置解析

在本文中将详细讲述struts.xml文件的常用配置及注意事项。

1.        使用<include>标签重用配置文件

在Struts2中提供了一个默认的struts.xml文件,但如果package、action、interceptors等配置比较多时,都放到一个struts.xml文件不太容易维护。因此,就需要将struts.xml文件分成多个配置文件,然后在struts.xml文件中使用<include>标签引用这些配置文件。这样做的优点如下:

结构更清晰,更容易维护配置信息。

配置文件可以复用。如果在多个Web程序中都使用类似或相同的配置文件,那么可以使用<include>标签来引用这些配置文件,这样可以减少工作量。

假设有一个配置文件,文件名为newstruts.xml,代码如下:


 

<? xml version="1.0" encoding="UTF-8"  ?>
<! DOCTYPE struts PUBLIC
    "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
    "http://struts.apache.org/dtds/struts-2.0.dtd"
>
< struts >
    
< package  name ="demo"  extends ="struts-default"   >
        
< action  name ="submit"   class ="action.MoreSubmitAction" >
            
< result  name ="save"   >
                /result.jsp
            
</ result >
            
< result  name ="print" >
                /result.jsp
            
</ result >
        
</ action >             
    
</ package >     
</ struts >


 struts.xml引用newstruts.xml文件的代码如下:

<? xml version="1.0" encoding="UTF-8"  ?>
<! DOCTYPE struts PUBLIC
    "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
    "http://struts.apache.org/dtds/struts-2.0.dtd"
>
< struts >
    
< include  file ="newstruts.xml" />
    
< package  name ="test"  extends ="struts-default" >
     
    
</ package >     
</ struts >


 

大家要注意一下,用<include>引用的xml文件也必须是完成的struts2的配置。实际上<include>在引用时是单独解析的xml文件,而不是将被引用的文件插入到struts.xml文件中。

2.        action的别名

 

    在默认情况下,Struts2会调用动作类的execute方法。但有些时候,我们需要在一个动作类中处理不同的动作。也就是用户请求不同的动作时,执行动作类中的不同的方法。为了达到这个目的,可以在<action>标签中通过method方法指定要指行的动作类的方法名,并且需要为不同的动作起不同的名子(也称为别名)。如下面代码所示:

<? xml version="1.0" encoding="UTF-8"  ?>
<! DOCTYPE struts PUBLIC
   "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
   "http://struts.apache.org/dtds/struts-2.0.dtd"
>
< struts >
< package  name ="demo"  extends ="struts-default"   >
    
< action  name ="test"   class ="action.MyAction" >
        
    
</ action >             
    
< action  name ="my"   class ="action. MyAction"  method ="my" >
         
    
</ action >             
</ package >     
</ struts >

上面代码的两个动作的class属性都指向同一个类,name为这个类起了两个动作别名:testmy。在动作my中,使用了method属性指定要要运行的方法名为my

    MyAction类中必须要有my方法,代码如下:

package  action;

import  com.opensymphony.xwork2.ActionSupport;

public   class  MyAction  extends  ActionSupport
{
     
    
public  String execute()  throws  Exception
    {
        
//  处理test动作的代码
    }
    
public  String my()  throws  Exception
    {
          
//  处理my动作的代码
    }
     
}



 

除了在struts.xml中配置别名,还可以通过请求参数来描述指定动作(并不需要在struts.xml中配置)。请求参数的格式如下:

http://localhost:8080/contextPath/actionName!method.action

关于通过请求指定动作的详细内容,请参阅笔者写的Struts2教程2:处理一个form多个submit

3.        action指定参数

struts2中还可以为action指定一个或多个参数。大家还记着struts1.x是如何设置的action参数不? struts1.x中可以使用<action>标签的parameter属性为其指定一个action参数,如果要指定多个,就只能通过逗号(,)或其他的分隔符将不同的参数隔开。而在struts2中可以通过<param>标签指定任意多个参数。代码如下:

< action  name ="submit"   class ="action.MyAction" >
< param  name ="param1" > value1 </ param >
< param  name ="param2" > value2 </ param >
    
< result  name ="save"   >
        /result.jsp
    
</ result >
     
</ action >        


    当然,在action中读这些参数也非常简单,只需要象获取请求参数一样在action类中定义相应的setter方法即可(一般不用定义getter方法)。如下面的代码将读取param1param2参数的值:

package  action;

import  com.opensymphony.xwork2.ActionSupport;

public   class  MyAction  extends  ActionSupport
{
    
private  String param1;
    
private  String param2;

    
public  String execute()  throws  Exception
    {
        System.out.println(param1 
+  param2);
    }
    
public   void  setParam1(String param1)
    {
        
this .param1  =  param1;
    }
    
public   void  setParam2(String param2)
    {
        
this .param2  =  param2;
    }
     
}


 

struts2在调用execute之前,param1param2的值就已经是相应参数的值了,因此,在execute方法中可以直接使用param1param2

4.        选择result类型

 

在默认时,<result>标签的type属性值是“dispatcher”(实际上就是转发,forward)。开发人员可以根据自己的需要指定不同的类型,如redirectstream等。如下面代码所示:

<result name="save" type="redirect">

       /result.jsp

</result>

这此result-type可以在struts2-core-2.0.11.1.jar包或struts2源代码中的struts-default.xml文件中找到,在这个文件中找到<result-types>标签,所有的result-type都在里面定义了。代码如下:

< result-types >
       
< result-type  name ="chain"  class ="com.opensymphony.xwork2.ActionChainResult" />
       
< result-type  name ="dispatcher"  class ="org.apache.struts2.dispatcher.ServletDispatcherResult"  default ="true" />
       
< result-type  name ="freemarker"  class ="org.apache.struts2.views.freemarker.FreemarkerResult" />
       
< result-type  name ="httpheader"  class ="org.apache.struts2.dispatcher.HttpHeaderResult" />
       
< result-type  name ="redirect"  class ="org.apache.struts2.dispatcher.ServletRedirectResult" />
       
< result-type  name ="redirectAction"  class ="org.apache.struts2.dispatcher.ServletActionRedirectResult" />
       
< result-type  name ="stream"  class ="org.apache.struts2.dispatcher.StreamResult" />
       
< result-type  name ="velocity"  class ="org.apache.struts2.dispatcher.VelocityResult" />
       
< result-type  name ="xslt"  class ="org.apache.struts2.views.xslt.XSLTResult" />
       
< result-type  name ="plainText"  class ="org.apache.struts2.dispatcher.PlainTextResult"   />
       
<!--  Deprecated name form scheduled for removal in Struts 2.1.0. The camelCase versions are preferred. See ww-1707  -->
       
< result-type  name ="redirect-action"  class ="org.apache.struts2.dispatcher.ServletActionRedirectResult" />
       
< result-type  name ="plaintext"  class ="org.apache.struts2.dispatcher.PlainTextResult"   />
</ result-types >

 

5.        全局result

有很多时候一个<result>初很多<action>使用,这时可以使用<global-results>标签来定义全局的<result>,代码如下:


 

< struts >
    
< package  name ="demo"  extends ="struts-default" >
        
< global-results >
            
< result  name ="print" > /result.jsp </ result >
        
</ global-results >
        
< action  name ="submit"  class ="action.MoreSubmitAction" >
         
        
</ action >
        
< action  name ="my"  class ="action.MoreSubmitAction"  method ="my" >
         
        
</ action >
    
</ package >
</ struts >


   如果
<action>中没有相应的<result>Struts2就会使用全局的<result>。

在本文中将详细讲述struts.xml文件的常用配置及注意事项。

1.        使用<include>标签重用配置文件

在Struts2中提供了一个默认的struts.xml文件,但如果package、action、interceptors等配置比较多时,都放到一个struts.xml文件不太容易维护。因此,就需要将struts.xml文件分成多个配置文件,然后在struts.xml文件中使用<include>标签引用这些配置文件。这样做的优点如下:

结构更清晰,更容易维护配置信息。

配置文件可以复用。如果在多个Web程序中都使用类似或相同的配置文件,那么可以使用<include>标签来引用这些配置文件,这样可以减少工作量。

假设有一个配置文件,文件名为newstruts.xml,代码如下:


 

<? xml version="1.0" encoding="UTF-8"  ?>
<! DOCTYPE struts PUBLIC
    "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
    "http://struts.apache.org/dtds/struts-2.0.dtd"
>
< struts >
    
< package  name ="demo"  extends ="struts-default"   >
        
< action  name ="submit"   class ="action.MoreSubmitAction" >
            
< result  name ="save"   >
                /result.jsp
            
</ result >
            
< result  name ="print" >
                /result.jsp
            
</ result >
        
</ action >             
    
</ package >     
</ struts >


 struts.xml引用newstruts.xml文件的代码如下:

<? xml version="1.0" encoding="UTF-8"  ?>
<! DOCTYPE struts PUBLIC
    "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
    "http://struts.apache.org/dtds/struts-2.0.dtd"
>
< struts >
    
< include  file ="newstruts.xml" />
    
< package  name ="test"  extends ="struts-default" >
     
    
</ package >     
</ struts >


 

大家要注意一下,用<include>引用的xml文件也必须是完成的struts2的配置。实际上<include>在引用时是单独解析的xml文件,而不是将被引用的文件插入到struts.xml文件中。

2.        action的别名

 

    在默认情况下,Struts2会调用动作类的execute方法。但有些时候,我们需要在一个动作类中处理不同的动作。也就是用户请求不同的动作时,执行动作类中的不同的方法。为了达到这个目的,可以在<action>标签中通过method方法指定要指行的动作类的方法名,并且需要为不同的动作起不同的名子(也称为别名)。如下面代码所示:

<? xml version="1.0" encoding="UTF-8"  ?>
<! DOCTYPE struts PUBLIC
   "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
   "http://struts.apache.org/dtds/struts-2.0.dtd"
>
< struts >
< package  name ="demo"  extends ="struts-default"   >
    
< action  name ="test"   class ="action.MyAction" >
        
    
</ action >             
    
< action  name ="my"   class ="action. MyAction"  method ="my" >
         
    
</ action >             
</ package >     
</ struts >

上面代码的两个动作的class属性都指向同一个类,name为这个类起了两个动作别名:testmy。在动作my中,使用了method属性指定要要运行的方法名为my

    MyAction类中必须要有my方法,代码如下:

package  action;

import  com.opensymphony.xwork2.ActionSupport;

public   class  MyAction  extends  ActionSupport
{
     
    
public  String execute()  throws  Exception
    {
        
//  处理test动作的代码
    }
    
public  String my()  throws  Exception
    {
          
//  处理my动作的代码
    }
     
}



 

除了在struts.xml中配置别名,还可以通过请求参数来描述指定动作(并不需要在struts.xml中配置)。请求参数的格式如下:

http://localhost:8080/contextPath/actionName!method.action

关于通过请求指定动作的详细内容,请参阅笔者写的Struts2教程2:处理一个form多个submit

3.        action指定参数

struts2中还可以为action指定一个或多个参数。大家还记着struts1.x是如何设置的action参数不? struts1.x中可以使用<action>标签的parameter属性为其指定一个action参数,如果要指定多个,就只能通过逗号(,)或其他的分隔符将不同的参数隔开。而在struts2中可以通过<param>标签指定任意多个参数。代码如下:

< action  name ="submit"   class ="action.MyAction" >
< param  name ="param1" > value1 </ param >
< param  name ="param2" > value2 </ param >
    
< result  name ="save"   >
        /result.jsp
    
</ result >
     
</ action >        


    当然,在action中读这些参数也非常简单,只需要象获取请求参数一样在action类中定义相应的setter方法即可(一般不用定义getter方法)。如下面的代码将读取param1param2参数的值:

package  action;

import  com.opensymphony.xwork2.ActionSupport;

public   class  MyAction  extends  ActionSupport
{
    
private  String param1;
    
private  String param2;

    
public  String execute()  throws  Exception
    {
        System.out.println(param1 
+  param2);
    }
    
public   void  setParam1(String param1)
    {
        
this .param1  =  param1;
    }
    
public   void  setParam2(String param2)
    {
        
this .param2  =  param2;
    }
     
}


 

struts2在调用execute之前,param1param2的值就已经是相应参数的值了,因此,在execute方法中可以直接使用param1param2

4.        选择result类型

 

在默认时,<result>标签的type属性值是“dispatcher”(实际上就是转发,forward)。开发人员可以根据自己的需要指定不同的类型,如redirectstream等。如下面代码所示:

<result name="save" type="redirect">

       /result.jsp

</result>

这此result-type可以在struts2-core-2.0.11.1.jar包或struts2源代码中的struts-default.xml文件中找到,在这个文件中找到<result-types>标签,所有的result-type都在里面定义了。代码如下:

< result-types >
       
< result-type  name ="chain"  class ="com.opensymphony.xwork2.ActionChainResult" />
       
< result-type  name ="dispatcher"  class ="org.apache.struts2.dispatcher.ServletDispatcherResult"  default ="true" />
       
< result-type  name ="freemarker"  class ="org.apache.struts2.views.freemarker.FreemarkerResult" />
       
< result-type  name ="httpheader"  class ="org.apache.struts2.dispatcher.HttpHeaderResult" />
       
< result-type  name ="redirect"  class ="org.apache.struts2.dispatcher.ServletRedirectResult" />
       
< result-type  name ="redirectAction"  class ="org.apache.struts2.dispatcher.ServletActionRedirectResult" />
       
< result-type  name ="stream"  class ="org.apache.struts2.dispatcher.StreamResult" />
       
< result-type  name ="velocity"  class ="org.apache.struts2.dispatcher.VelocityResult" />
       
< result-type  name ="xslt"  class ="org.apache.struts2.views.xslt.XSLTResult" />
       
< result-type  name ="plainText"  class ="org.apache.struts2.dispatcher.PlainTextResult"   />
       
<!--  Deprecated name form scheduled for removal in Struts 2.1.0. The camelCase versions are preferred. See ww-1707  -->
       
< result-type  name ="redirect-action"  class ="org.apache.struts2.dispatcher.ServletActionRedirectResult" />
       
< result-type  name ="plaintext"  class ="org.apache.struts2.dispatcher.PlainTextResult"   />
</ result-types >

 

5.        全局result

有很多时候一个<result>初很多<action>使用,这时可以使用<global-results>标签来定义全局的<result>,代码如下:


 

< struts >
    
< package  name ="demo"  extends ="struts-default" >
        
< global-results >
            
< result  name ="print" > /result.jsp </ result >
        
</ global-results >
        
< action  name ="submit"  class ="action.MoreSubmitAction" >
         
        
</ action >
        
< action  name ="my"  class ="action.MoreSubmitAction"  method ="my" >
         
        
</ action >
    
</ package >
</ struts >


   如果
<action>中没有相应的<result>Struts2就会使用全局的<result>。

 

 

Struts2教程4:使用validate方法验证数据

Struts2中最简单的验证数据的方法是使用validate。我们从ActionSupport类的源代码中可以看到,ActionSupport类实现了一个Validateable接口。这个接口只有一个validate方法。如果Action类实现了这个接口,Struts2在调用execute方法之前首先会调用这个方法,我们可以在validate方法中验证,如果发生错误,可以根据错误的level选择字段级错误,还是动作级错误。并且可使用addFieldErroraddActionError加入相应的错误信息,如果存在ActionField错误,Struts2会返回“input”(这个并不用开发人员写,由Struts2自动返回),如果返回了“input”,Struts2就不会再调用execute方法了。如果不存在错误信息,Struts2在最后会调用execute方法。

这两个add方法和ActionErrors类中的add方法类似,只是add方法的错误信息需要一个ActionMessage对象,比较麻烦。除了加入错误信息外,还可以使用addActionMessage方法加入成功提交后的信息。当提交成功后,可以显示这些信息。

 

以上三个add方法都在ValidationAware接口中定义,并且在ActionSupport类中有一个默认的实现。其实,在ActionSupport类中的实现实际上是调用了ValidationAwareSupport中的相应的方法,也就是这三个add方法是在ValidationAwareSupport类中实现的,代码如下:

private   final  ValidationAwareSupport validationAware  =   new  ValidationAwareSupport();

public   void  addActionError(String anErrorMessage) 
{      validationAware.addActionError(anErrorMessage);
}
public   void  addActionMessage(String aMessage) 
{
    validationAware.addActionMessage(aMessage);
}
public   void  addFieldError(String fieldName, String errorMessage) 
{
    validationAware.addFieldError(fieldName, errorMessage);
}

下面我们来实现一个简单的验证程序,来体验一个validate方法的使用。

先来在Web根目录建立一个主页面(validate.jsp),代码如下:

 


 

< %@ page  language ="java"  import ="java.util.*"  pageEncoding ="GBK" % >
< %@ taglib  prefix ="s"  uri ="/struts-tags"  % >
< html >
  
< head >
    
< title > 验证数据 </ title >
  
</ head >
  
  
< body >
    
< s:actionerror />
    
< s:actionmessage />
    
< s:form  action ="validate.action"   theme ="simple" >
        输入内容:
< s:textfield  name ="msg" />
         
< s:fielderror  key ="msg.hello"   />
         
< br />  
        
< s:submit />
    
</ s:form >
  
</ body >
</ html >

在上面的代码中,使用了Struts2tag<s:actionerror><s:fielderror><s:actionmessage>,分别用来显示动作错误信息,字段错误信息,和动作信息。如果信息为空,则不显示。

现在我们来实现一个动作类,代码如下:

 


 

package  action;

import  javax.servlet.http. * ;

import  com.opensymphony.xwork2.ActionSupport;
import  org.apache.struts2.interceptor. * ;

public   class  ValidateAction  extends  ActionSupport
{
    
private  String msg;
    
public  String execute() 
    {
        System.out.println(SUCCESS);
        
return  SUCCESS;
    }
    
public   void  validate()
    {
        
if ( ! msg.equalsIgnoreCase( " hello " ))
        {
            System.out.println(INPUT);
            
this .addFieldError( " msg.hello " " 必须输入hello! " );
            
this .addActionError( " 处理动作失败! " );
        }
        
else
        {
            
this .addActionMessage( " 提交成功 " );
        }
    }
    
public  String getMsg()
    {
        
return  msg;
    }
    
public   void  setMsg(String msg)
    {
        
this .msg  =  msg;
    }
}

 


 

大家从上面的代码可以看出,Field错误需要一个key(一般用来表示是哪一个属性出的错误),而Action错误和Action消息只要提供一个信息字符串就可以了。

最后来配置一下这个Action,代码如下:

< package  name ="demo"  extends ="struts-default" >
    
< action  name ="validate"  class ="action.ValidateAction" >
        
< result  name ="success" > /error/validate.jsp </ result >
        
< result  name ="input" > /error/validate.jsp </ result >
    
</ action >
</ package >

 


 

假设应用程序的上下文路径为demo,则可通过如下的URL来测试程序:

http://localhost:8080/demo/validate.jsp

我们还可以使用ValidationAware接口的其他方法(由ValidationAwareSupport类实现)获得或设置字段错误信息、动作错误信息以及动作消息。如hasActionErrors方法判断是否存在动作层的错误,getFieldErrors获得字段错误信息(一个Map对象)。下面是ValidationAware接口提供的所有的方法:

 


 

package  com.opensymphony.xwork2;

import  java.util.Collection;
import  java.util.Map;

public   interface  ValidationAware
{
    
void  setActionErrors(Collection errorMessages);
    Collection getActionErrors();

    
void  setActionMessages(Collection messages);
    Collection getActionMessages();
    
void  setFieldErrors(Map errorMap);
    Map getFieldErrors();
    
void  addActionError(String anErrorMessage);
    
void  addActionMessage(String aMessage);
    
void  addFieldError(String fieldName, String errorMessage);
    
boolean  hasActionErrors();
    
boolean  hasActionMessages();
    
boolean  hasErrors();
    
boolean  hasFieldErrors();
}

 


Struts2教程5:使用Validation框架验证数据

在《Struts2教程4:使用validate方法验证数据》中曾讲到使用validate方法来验证客户端提交的数据,但如果使用validate方法就会将验证代码和正常的逻辑代码混在一起,但这样做并不利于代码维护,而且也很难将过些代码用于其他程序的验证。在Struts2中为我们提供了一个Validation框架,这个框架和Struts1.x提供的Validation框架类似,也是通过XML文件进行配置。

一、服务端验证

下面将给出一个例子来演示如何使用Struts2validation框架来进行服务端验证。我们可以按着如下四步来编写这个程序:

【第1步】建立Action类(NewValidateAction.java

package  action;

import  com.opensymphony.xwork2.ActionSupport;

public   class  NewValidateAction  extends  ActionSupport
{
    
private  String msg;   //  必须输入
     private   int  age;    //  在13和20之间
     public  String getMsg()
    {
        
return  msg;
    }
    
public   void  setMsg(String msg)
    {
        
this .msg  =  msg;
    }
    
public   int  getAge()
    {
        
return  age;
    }
    
public   void  setAge( int  age)
    {
        
this .age  =  age;
    }
}

 

下面我们来验证msgage属性。

【第2步】配置Action类,struts.xml的代码如下:


<? xml version="1.0" encoding="UTF-8"  ?>
<! DOCTYPE struts PUBLIC
    "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
    "http://struts.apache.org/dtds/struts-2.0.dtd"
>
< struts >
    
< package  name ="demo"  extends ="struts-default"  namespace ="/test" >
        
< action  name ="new_validate"  class ="action.NewValidateAction" >
            
< result  name ="input" > /validate_form.jsp </ result >
            
< result  name ="success" > /validate_form.jsp </ result >
        
</ action >
    
</ package >
</ struts >

【第3步】编写验证规则配置文件


    这是一个基于XML的配置文件,和struts1.x中的validator框架的验证规则配置文件类似。但一般放到和要验证的.class文件在同一目录下,而且配置文件名要使用如下两个规则中的一个来命名:

<ActionClassName>-validation.xml

<ActionClassName>-<ActionAliasName>-validation.xml

其中<ActionAliasName>就是struts.xml<ation>name属性值。在本例中我们使用第一种命名规则,所以文件名是NewValidateAction-validation.xml。文件的内容如下:


<? xml version="1.0" encoding="UTF-8" ?>
<! DOCTYPE validators PUBLIC "-//OpenSymphony Group//XWork Validator 1.0.2//EN"
"http://www.opensymphony.com/xwork/xwork-validator-1.0.2.dtd"
>
< validators >
    
< field  name ="msg" >
        
< field-validator  type ="requiredstring" >
            
< message > 请输入信息 </ message >
        
</ field-validator >
    
</ field >
    
< field  name ="age" >
        
< field-validator  type ="int" >
            
< param  name ="min" > 13 </ param >
            
< param  name ="max" > 20 </ param >
            
< message >
                必须在 13至20之间
            
</ message >
        
</ field-validator >
    
</ field >
</ validators >

这个文件使用了两个规则:requiredstring(必须输入)和int(确定整型范围)。关于其他更详细的验证规则,请读者访问http://struts.apache.org/2.0.11.1/docs/validation.html来查看。

【第4步】编写数据录入JSP页。

Web根目录中建立一个validate_form.jsp文件,代码如下:

< %@ page  language ="java"  import ="java.util.*"  pageEncoding ="GBK" % >
< %@ taglib  prefix ="s"  uri ="/struts-tags"  % >
< link  rel ="stylesheet"  type ="text/css"  href ="<s:url value=" /styles/styles.css" /> ">
< html >
  
< head >
    
< title > 验证数据 </ title >
  
</ head >   
  
< body >
    
< s:form  action ="new_validate"  namespace ="/test"   >
        
< s:textfield  name ="msg"  label ="姓名"    />
        
< s:textfield  name ="age"  label ="年龄" />  
        
< s:submit />
    
</ s:form >  
  
</ body >   
</ html >

大家要注意一下,如果在struts.xml<package>标签中指定namespace属性,需要在<s:form>中也将namespaceaction分开写,如上面代码所示。不能将其连在一起,Struts2需要分开的actionnamespace。如下面的代码是错误的:

<s:form action="/test/new_validate" >

   ... ...

</s:form>

在上面的程序中还使用了一个styles.css来定制错误信息的风格。代码如下:

.label {font-style:italic; }

.errorLabel {font-style:italic; color:red; }

.errorMessage {font-weight:bold; color:red; }

    需要在Web根目录中建立一个styles目录,并将styles.css   

假设Web工程的上下文路径是validation,可以使用如下的URL来测试这个程序:

    http://localhost:8080/validation/validate_form.jsp

    显示结果如图1所示。



1

二、客户端验证

 

Struts2中实现客户端验证非常简单,只需要在<s:form>中加入一个validate属性,值为true。如<s:form validate="true" ... > ... </form>即可。

三、验证嵌套属性

    有一类特殊的属性,即这个属性的类型是另外一个JavaBean,如有一个User类,代码如下:

package  data;

public   class  User
{
    
private  String name;
    
private   int  age;
    
public  String getName()
    {
        
return  name;
    }
    
public   void  setName(String name)
    {
        
this .name  =  name;
    }
    
public   int  getAge()
    {
        
return  age;
    }
    
public   void  setAge( int  age)
    {
        
this .age  =  age;
    }
}

NewValidateAction类中加一个user属性,代码如下:

package  action;

import  com.opensymphony.xwork2.ActionSupport;
import  data.User;

public   class  NewValidateAction  extends  ActionSupport
{
    
private  String msg;
    
private   int  age;
    
private  User user;
    
public  String getMsg()
    {
        
return  msg;
    }

    
public   void  setMsg(String msg)
    {
        
this .msg  =  msg;
    }
    
public   int  getAge()
    {
        
return  age;
    }
    
public   void  setAge( int  age)
    {
        
this .age  =  age;
    }
    
public  User getUser()
    {
        
return  user;
    }
    
    
public   void  setUser(User user)
    {
        
this .user  =  user;
    }
}

如果要验证NewValidateAction中的user属性,可以使用visitor验证器。操作过程如下:

首先在NewValidateAction-validation.xml中加入一个<field>标签,代码如下:


<? xml version="1.0" encoding="UTF-8" ?>
<! DOCTYPE validators PUBLIC "-//OpenSymphony Group//XWork Validator 1.0.2//EN"
"http://www.opensymphony.com/xwork/xwork-validator-1.0.2.dtd"
>
< validators >
     
    
< field  name ="user" >
    
< field-validator  type ="visitor" >
            
< param  name ="context" > abc </ param >
            
< param  name ="appendPrefix" > true </ param >
            
< message > User: </ message >
        
</ field-validator >
    
</ field >
</ validators >

其中context参数将作为验证User类属性的文件名的一部分,如user属性返回一个User对象,那么用于验证User对象属性的文件名为User-abc-validation.xml。这个文件要和User.class文件在同一个目录中。appendPrefix表示是否在字段里加user,如果为trueStruts2就会使用user.nameform提交的数据中查找要验证的数据。这个属性的默认值是true。如果出错,Struts2会将<message>标签中的信息加到User-abc-validation.xml文件中的相应错误信息前面。

User-abc-validation.xml文件的内容如下:

<? xml version="1.0" encoding="UTF-8" ?>
<! DOCTYPE validators PUBLIC "-//OpenSymphony Group//XWork Validator 1.0.2//EN"
 "http://www.opensymphony.com/xwork/xwork-validator-1.0.2.dtd"
>
< validators >
    
< field  name ="name" >
        
< field-validator  type ="requiredstring" >
            
< message > 请输入name </ message >
        
</ field-validator >
    
</ field >
    
< field  name ="age" >
        
< field-validator  type ="int" >
            
< param  name ="min" > 5 </ param >
            
< param  name ="max" > 20 </ param >
            
< message >
                必须在 5至20之间
            
</ message >
        
</ field-validator >
    
</ field >
</ validators >

下面修改validate_form.jsp,代码如下:


< s:form  validate ="true"  action ="new_validate"  namespace ="/test"   >
     
< s:textfield  name ="msg"  label ="姓名"    />
     
< s:textfield  name ="age"  label ="年龄" />  
     
< s:textfield  name ="user.name"  label ="姓名1"    />
     
< s:textfield  name ="user.age"  label ="年龄1" />  
    
< s:submit />
</ s:form >

                                                   

 

 

 

 

                                           2

 

    经笔者测试,使用visitor无法以客户端验证的方式来验证user属性,但NewValidateAction中其他的属性可以使用客户端测试。

 

Struts2教程6:在Action类中获得HttpServletResponse对象的四种方法

 

在struts1.x Action类的execute方法中,有四个参数,其中两个就是responserequest。而在Struts2中,并没有任何参数,因此,就不能简单地从execute方法获得HttpServletResponseHttpServletRequest对象了。

    但在Struts2 Action类中仍然有很多方法可以获得这些对象。下面就列出四种获得这些对象的方法。

【方法1】使用Struts2 Aware拦截器

 

    这种方法需要Action类实现相应的拦截器接口。如我们要获得HttpServletResponse对象,需要实现org.apache.struts2.interceptor.ServletResponseAware接口,代码如下:

package  action;

import  com.opensymphony.xwork2.ActionSupport;
import  javax.servlet.http. * ;
import  org.apache.struts2.interceptor. * ;

public   class  MyAction  extends  ActionSupport  implements  ServletResponseAware
{
    
private  javax.servlet.http.HttpServletResponse response;
    
//  获得HttpServletResponse对象
     public   void  setServletResponse(HttpServletResponse response)
    {
        
this .response  =  response;
    }    
    
public  String execute()  throws  Exception
    {    
        response.getWriter().write(
" 实现ServletResponseAware接口 " );
    }
}

 

在上面的代码中,MyAction实现了一个ServletResponseAware接口,并且实现了setServletResponse方法。如果一个动作类实现了ServletResponseAware接口,Struts2在调用execute方法之前,就会先调用setServletResponse方法,并将response参数传入这个方法。如果想获得HttpServletRequestHttpSessionCookie等对象,动作类可以分别实现ServletRequestAwareSessionAwareCookiesAware等接口。这些接口都在org.apache.struts2.interceptor包中。

如果要获得请求参数,动作类可以实现org.apache.struts2.interceptor. ParameterAware接口,但如果只想判断某个参数是否存在,也可以实现com.opensymphony.xwork2.interceptor. ParameterNameAware接口。这个接口有一个acceptableParameterName方法,当Struts2获得一个请求参数时,就会调用一次。读者可以在这个方法中将所有的请求参数记录下来,以便以后使用。这个方法的定义如下:

boolean acceptableParameterName(String parameterName);

【方法2】使用RequestAware拦截器

    这种方法和第1种方法类似。动作类需要实现一个org.apache.struts2.interceptor.RequestAware接口。所不同的是RequestAware将获得一个com.opensymphony.xwork2.util.OgnlValueStack对象,这个对象可以获得responserequest及其他的一些信息。代码如下所示:

 


 

package  action;

import  java.util.Map;
import  org.apache.struts2. * ;
import  com.opensymphony.xwork2.ActionSupport;
import  javax.servlet.http. * ;
import  com.opensymphony.xwork2.util. * ;
import  org.apache.struts2.interceptor. * ;

public   class  FirstAction  extends  ActionSupport  implements  RequestAware
{
    
private  Map request;
private  HttpServletResponse response;
    
    
public   void  setRequest(Map request)
    {
        
this .request  =  request;        
    }    
    
public  String execute()  throws  Exception
    {    
        java.util.Set
< String >  keys  =  request.keySet();
        
//  枚举所有的key值。实际上只有一个key:struts.valueStack
         for (String key: keys)
            System.out.println(key);
        
//  获得OgnlValueStack 对象
        OgnlValueStack stack  =  (OgnlValueStack)myRequest.get( " struts.valueStack " );
        
//  获得HttpServletResponse对象
        response  = (HttpServletResponse)stack.getContext().get(StrutsStatics.HTTP_RESPONSE);
        response.getWriter().write(
" 实现RequestAware 接口 " );
    }
}

 


 

    我们也可以使用StrutsStatics.HTTP_REQUESTStrutsStatics.PAGE_CONTEXT来获得HttpServletRequestPageContext对象。这种方法有些麻烦,一般很少用,读者可以作为一个参考。

【方法3】使用ActionContext

 

    这种方法比较简单,我们可以通过org.apache.struts2.ActionContext类的get方法获得相应的对象。代码如下:

    HttpServletResponse response(HttpServletResponse) =

ActionContext.getContext().get(org.apache.struts2.StrutsStatics.HTTP_RESPONSE);

HttpServletRequest request(HttpServletRequest) =

ActionContext.getContext().get(org.apache.struts2.StrutsStatics.HTTP_REQUEST);

【方法4】使用ServletActionContext

    Struts2为我们提供了一种最简单的方法获得HttpServletResponse及其他对象。这就是org.apache.struts2.ServletActionContext类。我们可以直接使用ServletActionContext类的getRequestgetResponse方法来获得HttpServletRequestHttpServletResponse对象。代码如下:

    HttpServletResponse response = ServletActionContext.getResponse()

    response.getWriter().write("hello world");

    从这四种方法来看,最后一种是最简单的,读者可以根据自己的需要和要求来选择使用哪一种方法来获得这些对象。

大家可以看到,最后两个<s:textfield>name属性是user.nameuser.age,正好是加了前缀的。

现在重新访问 http://localhost:8080/validation/validate_form.jsp,验证界面如图2所示。


  • 1
    点赞
  • 5
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值