常见的配置文件配置有以下两种:
<action name="adminProduct_*" class="adminProductAction" method="{1}">
<result name="findAll">/admin/product/list.jsp</result>
<result name="addPageSuccess">/admin/product/add.jsp</result>
</action>
<action name="adminProduct_*" class="adminProductAction" method="{1}">
<result name="SUCCESS">/admin/product/list.jsp</result>
</action>
第一种是返回自定义字符串,自己定义返回的字符串,配置到配置文件中,查找相应的页面。第二种是struts默认的字符串,例如SUCCESS或者ERROR。result的type不定义的话,默认就是dispatcher类型,这种类型就是处理页面的,通常是用在JSP页面中。除了dispatcher类型,struts2还提供了其他类型。
chain类型
com.opensymphony.xwork2.ActionChainResult类,用来处理Action链,也就是说Struts2在处理过程中,是一系列的Action进行的,并不是某一个,所以配置Chain类型就是跳转到某一个Action。struts2通过拦截器拦截源Action,将参数、session等传给目的Action,在这个过程中ActionContext实现共享,于是形成了Action链。在chain类型中,name代表目的Action,method代表目的Action中的方法。但是在struts2框架中,这种类型已不推荐使用,而是采用redirect-action的方式。
redirect类型
redirect类型是重定向,和默认的dispatcher类型是对应的。dispatcher是转发到某一个页面,这时参数和session等都继续传递。而redirect类型则是重定向,参数和session不共用,而是开启一个新的。重定向将丢失参数、值栈和Action处理的结果,所以在使用时要注意。
<action name="adminUser_*" class="adminUserAction" method="{1}">
<result name="loginFail">/admin/index.jsp</result>
<result name="loginSuccess" type="redirect">/admin/home.jsp</result>
</action>
redirect-action类型
redirect-action类型是重定向到Action,跟chain类似,但是redirect-action类型是重新定向到一个URL,它的结果和redirect类型类似。
<action name="adminProduct_*" class="adminProductAction" method="{1}">
<result name="findAll">/admin/product/list.jsp</result>
<result name="addPageSuccess">/admin/product/add.jsp</result>
<result name="saveSuccess" type="redirectAction">adminProduct_findAll.action?page=1</result>
<result name="deleteSuccess" type="redirectAction">adminProduct_findAll.action?page=1</result>
<result name="editSuccess">/admin/product/edit.jsp</result>
<result name="updateSuccess" type="redirectAction">adminProduct_findAll.action?page=1</result>
</action>
velocity类型
velocity类型是处理velocity模板的,它的result只能是velocity模板,也就是平常所见的.vm文件。velocity模板类似于JSP,它里面可以写JS、HTML,控件赋值的话类似于struts的标签。只不过用velocity有一个不方便的,就是重复性有点大,因为一个action只能对应一个velocity模板。例如页面中有一个下拉框,点击下拉框选项改变页面数据,这时下拉框有几个选项就要建几个页面,每个页面除了下拉框选项点击触发的action不同,其他都一样。配置文件定义时,需要把type定义为velocity,action中也要返回struts默认的字符串。
<action name="adminProduct_*" class="adminProductAction" method="{1}">
<result name="velocity">/admin/product/list.vm</result>
</action>
freemarker类型
freemarker类型和velocity类型相似,是用来处理freemarker模板的。freemarker模板同样类似于JSP,都是视图文件,相差也不多。
<action name="adminProduct_*" class="adminProductAction" method="{1}">
<result name="velocity">/admin/product/list.ftl</result>
</action>
httpheader类型
httpheader类型是处理HTTP的结果类型,通过接收返回的自定义的HttpHeader,根据相应的status做出相应的处理。
stream类型
stream类型向浏览器发送InputStream文件,用于处理文件下载。
plaintext类型
plaintext类型是以原始文本的形式显示JSP或者HTML
在struts2框架中,当action处理完之后,就应该向用户返回结果信息,该任务被分为两部分:结果类型和结果本身。
结果类型提供了返回给用户信息类型的实现细节。结果类型通常在Struts2中就已预定义好了(见下表),或者是由插件提供,开发人员也可以自定义结果类型。默认配置的结果类型是dispatcher,该结果类型使用JSP来向用户显示结果。当定义了结果类型之后,该结果类型可以在不同的action中重复使用。
?
Struts2框架提供的结果类型
已配置结果类型名 | 类 名 | 描 述 |
dispatcher | org.apache.struts2.dispatcher. ServletDispatcherResult | 默认结果类型,用来呈现JSP页面 |
---|---|---|
chain | com.opensymphony.xwork2. ActionChainResult | 将action和另外一个action链接起来 |
freemarker | org.apache.struts2.views.freemarker. FreemarkerResult | 呈现Freemarker模板 |
httpheader | org.apache.struts2.dispatcher. HttpHeaderResult | 返回一个已配置好的HTTP头信息响应 |
redirect | org.apache.struts2.dispatcher. ServletRedirectResult | 将用户重定向到一个已配置好的URL |
redirectAction | org.apache.struts2.dispatcher. ServletActionRedirectResult | 将用户重定向到一个已定义好的action |
stream | org.apache.struts2.dispatcher. StreamResult | 将原始数据作为流传递回浏览器端, 该结果类型对下载的内容和图片非常有用 |
velocity | org.apache.struts2.dispatcher. VelocityResult | 呈现Velocity模板 |
xslt | org.apache.struts2.views.xslt. XSLTResult | 呈现XML到浏览器, 该XML可以通过XSL模板进行转换 |
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也是可以返回json的,但是需要添加相关的jar包的:、json-lib-2.1-jdk15.jar、struts2-json-plugin-2.1.8.1.jar,而且在struts的配置文件中需要继承json-default,如下所示:
<struts>
<package name="emp" extends="struts-default,json-default">
……
</package>
<struts>