struts2 action中result参数详解

 



struts2项目如何引入redis struts2 action result_struts2项目如何引入redis


chain  
 

   
   
   
   
 用来处理Action链  
 

   
   
   
   
 com.opensymphony.xwork2.ActionChainResult  
 

 dispatcher  
 

   
   
   
   
 用来转向页面,通常处理JSP  
 

   
   
   
   
 org.apache.struts2.dispatcher.ServletDispatcherResult  
 

 freemaker  
 

   
   
   
   
 处理FreeMarker模板  
 

   
   
   
   
 org.apache.struts2.views.freemarker.FreemarkerResult  
 

 httpheader  
 

   
   
   
   
 控制特殊HTTP行为的结果类型  
 

   
   
   
   
 org.apache.struts2.dispatcher.HttpHeaderResult  
 

 redirect  
 

   
   
   
   
 重定向到一个URL  
 

   
   
   
   
 org.apache.struts2.dispatcher.ServletRedirectResult  
 

 redirectAction  
 

   
   
   
   
 重定向到一个Action  
 

   
   
   
   
 org.apache.struts2.dispatcher.ServletActionRedirectRes 
 ult  
 

 stream  
 

   
   
   
   
 向浏览器发送InputSream对象,通常用来处理文件下载,还可用于返回AJAX数据  
 

   
   
   
   
 org.apache.struts2.dispatcher.StreamResult  
 

 velocity  
 

   
   
   
   
 处理Velocity模板  
 

   
   
   
   
 org.apache.struts2.dispatcher.VelocityResult  
 

 xslt  
 

   
   
   
   
 处理XML/XLST模板  
 

   
   
   
   
 org.apache.struts2.views.xslt.XSLTResult  
 

 plainText  
 

   
   
   
   
 显示原始文件内容,例如文件源代码  
 

   
   
   
   
 org.apache.struts2.dispatcher.PlainTextResult  
 

 redirect-action  
 

   
   
   
   
 重定向到一个Action  
 

   
   
   
   
 org.apache.struts2.dispatcher.ServletActionRedirectRes 
 ult  
 

 plaintext  
 

   
   
   
   
 显示原始文件内容,例如文件源代码  
 

   
   
   
   
 org.apache.struts2.dispatcher.PlainTextResult



简单说明一下result的name属性和type属性: 
SUCCESS:Action正确的执行完成,返回相应的视图,success是name属性的默认值; 
NONE:表示Action正确的执行完成,但并不返回任何视图; 
ERROR:表示Action执行失败,返回到错误处理视图; 
INPUT:Action的执行,需要从前端界面获取参数,INPUT就是代表这个参数输入的界面,一般在应用中,会对这些参数进行验证,如果验证没有通过,将自动返回到该视图; 
LOGIN:Action因为用户没有登陆的原因没有正确执行,将返回该登陆视图,要求用户进行登陆验证。 
dispatcher: 请求转发,底层调用RequestDispatcher的forward()或include()方法,dispatcher是  type属性的默认值, 通常用于转向一个JSP,localtion指定JSP的位置,parse如果为false表示location的值不会被当作  OGNL解析,默认为 true; 
redirect:重定向,新页面无法显示Action中的数据,因为底层调用response.sendRedirect("")方法,无法共享请求范围内的数据,参数与dispatcher用法相同; 
redirect- action:重定向到另一个Action,参数与chain用法相同,允许将原Action中的属性指定新名称带入新Action  中,可以在 Result标签中添加  <param  name=”b”>${a}  </param>,这表示原Action中的变量a的值被 转给b,下一个Action可以在值栈中使用b来操作,注意如果值是中文,需要做一些编码处理,因为Tomcat默认是不支持URL直接传递中文的! 
velocity:使用velocity模板输出结果,location指定模板的位置(*.vm),parse如果为false,location不被OGNL解析,默认为true; 
xslt: 使用XSLT将结果转换为xml输出,location指定*.xslt文件的位置,parse如果为false,location不被  OGNL解析, 默认为true,matchingPattern指定想要的元素模式,excludePattern指定拒绝的元素模式,支持正则表达式,默认为接受所有 元素; 
httpheader:根据值栈返回自定义的HttpHeader,status指定响应状态(就是指 response.sendError(int  i)重定向到500等服务器的状态页),parse如果为false,header的值不会被OGNL解 析,headers,加入到header中的值,例如:  <param  name=”headers.a”>HelloWorld  < /param>,可以加多个,这些键-值组成HashMap; 
freemaker:用freemaker模板引擎呈现视图,location指定模板(*.ftl)的位置,parse如果为false,location的值不会被OGNL解析,contentType指定以何中类型解析,默认为text/html; 
chain: 将action的带着原来的状态请求转发到新的action,两个action共享一个ActionContext,actionName指定转向的新的 Action的名字,method指定转向哪个方法,namespace指定新的Action的名称空间,不写表示与原Action在相同的名称空 间;skipActions指定一个使用  ,  连接的Action的name组成的集合,一般不建议使用这种类型的结果; 
stream:直接向 响应中发送原始数据,通常在用户下载时使用,contentType指定流的类型,默认为  text/plain,contentLength以byte 计算流的长度,contentDisposition指定文件的位置,通常为  filename=”文件的位置”,input指定InputStream 的名字,例如:imageStream,bufferSize指定缓冲区大小,默认为1024字节; 
plaintext:以原始文本显示JSP或者HTML,location指定文件的位置,charSet指定字符集;

Struts2支持的不同类型的返回结果为:

名字                          说明


                                            用来处理Action链



                            用来转向页面,通常处理JSP



                          处理FreeMarker模板



                        用来控制特殊的Http行为



                                    重定向到一个URL



Action              重定向到一个Action



                                      向浏览器发送InputSream对象,通常用来处理文件下载



                                  处理Velocity模板



                                                处理XML/XLST模板



                              显示原始文件内容,例如文件源代码



   结合Tile使用

dispatcher 为默认跳转类型,用于返回一个视图资源(如:jsp)
Xml代码 :

<resultname="success">/main.jsp</result>
<resultname="success">/main.jsp</result>
以上写法使用了两个默认,其完整的写法为:

<result name="success"type="dispatcher">
        <paramname="location">/maini.jsp</param>
 </result>

用于页面转发,页面跳转过程一直是同一个线程,Action中的数据一直保存着。
location只能是页面,不能是另一个action(可用type="chain"解决)。


类型用于重定向到一个页面,另一个action或一个网址。
Xml代码:

name="success"type="redirect">aaa.jsp</result>
 <result name="success"type="redirect">bbb.action</result>
 <result name="success"type="redirect">www.baidu.com</result>

缺点:redirect把一个http返回码(SUCCESS)以及返回的页面位置一起重新发给web服务器,容纳后由web服务器产生一个新的HTTP请求,就会产生一个新的线程,保存在原来Action执行的线程中的数据就无法访问。
所以,result需要包含Action的数据,那么redirect不是一个可行的办法。因为新的HTTP请求时在Servlet容器的新的线程中处理的,ActionContext中的所有状态都不会存在。

处理方法:

(方法一):
 <result name="topic"type="redirect">/topicAction!findTopics.do?topicId=${topicId}</result>
 (方法二):
 <result name="topic"type="redirect-action">
 <paramname="actionName">findTopics</param>
 <paramname="topicId">${topicId}</param>
 </result>


redirect-action结果类型使用ActionMapperFactory提供的ActionMapper来重定向请求到另外一个action
Xml代码:

name="err"type="redirect-action">
    <paramname="actionName">重定向的Action名</param>
     <paramname="namespace">重定向Action所在的名字空间</param>
 </result>


redirect和redirect-action两种结果类型在使用上其实并没有什么区别,只是写法不同而已。


用于把相关的几个action连接起来,共同完成一个功能。
Xml代码:

name="step1"class="test.Step1Action">
     <result name="success"type="chain">step2.action</result>
 </action>
 <action name="step2"class="test.Step2Action">
 <resultname="success">finish.jsp</result>
 </action>


处于chain中的action属于同一个http请求,共享一个ActionContext


结果类型用于直接在页面上显示源代码

Xml代码:

<result  
 name="err"type="plaintext"> 
 
 <paramname="location">具体的位置</param>
    <paramname="charSet">字符规范(如GBK)</param>
 </result>

在strutx.xml配置文件中,我们可以使用${nextAction}来引用到Action中的属性,通过${nextAction}表示的内容来动态的返回结果,例如:


name="fragment"  
  class="FragmentAction"> 
 
 
 
name="next"  
  type="redirect-action">${nextAction}</result> 
 
 
 

   </action>


一个提交到服务器的处理通常可以分为两个阶段,第一个阶段查询服务器状态(查询或者更新数据库),第二个阶段选择一个合适的结果页面其返回给用户(这里要讲的Result的内容)。




Struts2提供了对不同种类返回结果的支持,常见的有JSP,FreeMarker,Velocity等。



Struts2支持的不同类型的返回结果为:



名字

说明

Chain Result

用来处理Action链

Dispatcher Result

用来转向页面,通常处理JSP

FreeMarker Result

处理FreeMarker模板

HttpHeader Result

用来控制特殊的Http行为

Redirect Result

重定向到一个URL

Redirect Action Result

重定向到一个Action

Stream Result

向浏览器发送InputSream对象,通常用来处理文件下载

Velocity Result

处理Velocity模板

XLS Result

处理XML/XLST模板

PlainText Result

显示原始文件内容,例如文件源代码

S2PLUGINS:Tiles Result

结合Tile使用

另外第三方的Result类型还包括JasperReports Plugin,专门用来处理JasperReport类型的报表输出。




在struts-default.xml文件中已经有了对于所有类型Result的定义:



<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>



从上述代码中可以看出在不指定Result类型的时候使用dispatcher类型。




定义一个Result值,



<result name="success" type="dispatcher"> 
  
 
  
<param name="location">/ThankYou.jsp</param>
 
  

    </result>



由于type默认值是dispatcher,所以这里不需要定义,另外name的默认值为success所以这里也不需要定义。



上述代码可以简写为:



<result> 
  
 
  
<param name="location">/ThankYou.jsp</param>
 
  
 </result>

另外location参数也可以直接卸载result标签内部,所以上述代码的最简单的写法为:



<result>/ThankYou.jsp</result>




我们也可以定义多个不同的Result



<action name="Hello"> 
  
 
  
<result>/hello/Result.jsp</result> 
  
 
  
<result name="error">/hello/Error.jsp</result> 
  
 
  
<result name="input">/hello/Input.jsp</result> 
  
 
  

    </action>


上述代码的含义为,名字为Hello的Action有三个返回结果,并且都是dispatcher类型(默认类型), 这三个返回值的名字分别为 success(默认值),error,input,对应的页面的路径分别为/hello/Result.jsp,/hello/Error.jsp, /hello/Input.jsp。




有些时候我们需要一个定义在全局的Result,这个时候我们可以在package内部定义全局的Result,例如:



<global-results> 
  
 
  
<result name="error">/Error.jsp</result> 
  
 
  
<result name="invalid.token">/Error.jsp</result> 
  
 
  
<result name="login" type="redirect-action">Logon!input</result> 
  
 
  
 </global-results>


动态返回结果



有些时候,只有当Action执行完璧的时候我们才知道要返回哪个结果,这个时候我们可以在Action内部定义一个属性,这个属性用来存储Action执行完璧之后的Result值,例如:



private String nextAction; 
  
 
   
  

    public String getNextAction() { 
  
 
  
return nextAction;
 
  

    }

在strutx.xml配置文件中,我们可以使用${nextAction}来引用到Action中的属性,通过${nextAction}表示的内容来动态的返回结果,例如:


<action name="fragment" class="FragmentAction"> 
  
 
  
<result name="next" type="redirect-action">${nextAction}</result> 
  
 
  

    </action>


上述Action的execute方法返回next的时候,还需要根据nextAction的属性来判断具体定位到哪个Action。