基本配置类型
在result的属性中:name配置逻辑视图名 type制定结果类型
在result的子集<param .../>中:location指定对应的视图资源,parse指定是否能在视图中使用OGNL表达式。
在struts的默认类型中type为dispatcher(用于与JSP整合的结果类型) name为默认值success
结果类型
<result-types>
<!-- Action链式处理结果类型 -->
<result-type name="chain" class="com.opensymphony.xwork2.ActionChainResult"/>
<!-- 指定使用JSP作为视图结果类型 -->
<result-type name="dispatcher" class="org.apache.struts2.dispatcher.ServletDispatcherResult" default="true"/>
<!-- 指定使用FreeMarker模板作为视图结果类型 -->
<result-type name="freemarker" class="org.apache.struts2.views.freemarker.FreemarkerResult"/>
<!-- 用于控制特殊的HTTP行为结果类型 -->
<result-type name="httpheader" class="org.apache.struts2.dispatcher.HttpHeaderResult"/>
<!-- 用于直接跳转URL结果类型 -->
<result-type name="redirect" class="org.apache.struts2.dispatcher.ServletRedirectResult"/>
<!-- 用于直接跳转其它的Action结果类型 -->
<result-type name="redirectAction" class="org.apache.struts2.dispatcher.ServletActionRedirectResult"/>
<!-- 用于向浏览器返回一个InputStream(一般用于文件下载) -->
<result-type name="stream" class="org.apache.struts2.dispatcher.StreamResult"/>
<!-- 指定使用Velocity模板作为视图结果类型 -->
<result-type name="velocity" class="org.apache.struts2.dispatcher.VelocityResult"/>
<!-- 与XML/XSLT整合的结果类型 -->
<result-type name="xslt" class="org.apache.struts2.views.xslt.XSLTResult"/>
<!-- 用于显示某个页面的原始代码的结果类型 -->
<result-type name="plainText" class="org.apache.struts2.dispatcher.PlainTextResult" />
</result-types>
在struts-default.xml中指定了支持的结果类型,并且dispatcher的default为true,则为默认的result类型。
plainText类型
<action name="login" class="app.action.LoginAction">
<result name="success" type="plainText">
<param name="location">/welcome.jsp</param>
<param name="charSet">GBK</param>
</result>
</action>
这里会将视图资源作为普通文本处理,则结果会输出页面源代码,需要注意的是,如果页面包含中文字符,需要通过charSet指定输出页面的字符集。
redirect类型
重定向URL地址,效果是重新发送一个请求,不过所有的请求参数、请求属性、及Action实例与Action封装的属性全部丢失。
redirectAction类型
<action name="login" class="app.action.LoginAction">
<result name="success" type="redirectAction">
<!-- 重定向的Action所在的命名空间 -->
<param name="namespace">/book</param>
<!-- 重定向的ActionName -->
<param name="actionName">test</param>
</result>
</action>
也是冲顶想URL地址,只是不过是另一个Action,不过前一个的Action的处理结果、请求参数、请求属性都会丢失。
Action的属性值决定视图资源
<action name="test" class="app.action.TestAction">
<result name="success">/${target}.jsp</result>
</action>
test.action中的视图资源有Action的属性值target决定。test.action?target=error 则返回的视图资源为error.jsp。
全局结果
<global-results>
<result name="success">/${target}.jsp</result>
</global-results>
<action name="test" class="app.action.TestAction">
</action>
如果当前范围内Action不设置result,则使用全局变量的result。
PreResultListener
ActionInvocation invocation=ActionContext.getContext().getActionInvocation();
invocation.addPreResultListener(new PreResultListener() {
@Override
public void beforeResult(ActionInvocation invocation, String resultCode) {
System.out.println("返回的逻辑视图"+resultCode);
invocation.getInvocationContext().put("extra", new java.util.Date()+"由"+resultCode+"逻辑视图转入");
}
});
监听器在转入屋里视图时,激发该监听器。
异常处理
捕获异常
<global-exception-mappings>
<exception-mapping result="sql" exception="java.sql.SQLException" />
<exception-mapping result="root" exception="java.lang.Exception" />
</global-exception-mappings>
这个异常捕捉在全局变量中,也可以申明局部异常映射。
result表示返回的逻辑视图
异常信息输出
<!-- 输出异常对象本身 -->
<s:property value="exception" />
<!-- 输出异常堆栈信息 -->
<s:property value="exceptionStack"/>
Convention插件
action的搜索和映射约定
首先引入struts2-convention-plugin-2.3.15.1.jar包
就会把所有实现了的com.opensymphony.xwork2.Action的JAVA类及类名以Action结尾的Java类当做Action处理
如下的例子 包名的根命名空间 actions、action、struts、struts2包会映射为根命名空间
com.actions.LoginAction /login.action
com.actions.books.GetBooks /books/get-books.action
com.action.LoginAction /login.action
com.struts.auction.bid.BidAction /auction/bid/bid.action
com.struts2.wage.hr.AddEmployeeAction /wage/hr/add-employee.action
按照约定的Result
默认情况下,路径是WEB-INF/content下,定位的资源是actionName+resultcode+suffix(.jsp或者.html) 如果找不到自动使用actionName+suffix
Action的URL | 返回的逻辑视图名 | 结果类型 | 对应的物理视图 |
/login | success | Dispatcher | \WEB-INF\content\login-success.jsp |
/login | success | Dispatcher | \WEB-INF\content\login-success.html |
/login | success | Dispatcher | \WEB-INF\content\login.jsp |
/login | success | Dispatcher | \WEB-INF\content\login.html |
/lee/get-book | error | FreeMarker | \WEB-INF\content\lee\get-book-error.ftl |
/lee/get-book | error | FreeMarker | \WEB-INF\content\lee\get-book.ftl |
/lee/get-book | Input | Velocity | \WEB-INF\content\lee\get-book-input.vm |
/lee/get | input | Velocity | \WEB-INF\content\lee\get-input.vm |
Action链约定
约定三个条件
第一个action返回的逻辑视图字符串没有响应的资源
第一个action与第二个action处于同一个包下
第二个action映射的URL为firstactionName+resultCode
自动重加载映射
<!-- 配置Struts 2 应用处于开发模式 -->
<constant name="struts.devMode" value="true" />
<!-- 配置Convention插件自动加载映射 -->
<constant name="struts.convention.classes.reload" value="true"></constant>