struts2 convention插件的使用(一)

struts2 convention插件的相关文章在网络上还很少，今天研究了一下

官方文档 http://cwiki.apache.org/WW/convention-plugin.html



Dynamic Web Project

eclipse3.3

jdk1.6

tomcat6



必要jar列表



commons-fileupload-1.2.1.jar

commons-logging-1.0.4.jar

freemarker-2.3.13.jar

ognl-2.6.11.jar

struts2-convention-plugin-2.1.6.jar

struts2-core-2.1.6.jar

xwork-2.1.2.jar

 
com.sunflower.actions.NavigatorAction
com.sunflower.actions.child.ChildAction
error.jsp
index.jsp
next.jsp
child/next.jsp
主题：确认action内默认执行方法是execute还是index
请求url：navigator.action 
类型：dispatcher
方法：execute或index
执行默认方法
主题：测试如何跳转到站外
请求url：navigator!redirect.action  
类型：redirect（旧版本使用ServletRedirectResult.class）
方法：redirect
跳转到站外
主题：测试redirectAction、basePackage内子包action的映射、以及参数传递
请求url：navigator!redirectAction.action  
类型：redirectAction （旧版本使用ServeltActionRedirectResult.class）
方法：redirectAction
location：child/child(basePackage=com.sunflower.actions,this package=com.sunflower.actions.child)
注意
1：ChildAction内的execute方法返回指向location="next.jsp"，查看结果页面next.jsp是根目录资源还是/child/next.jsp资源
2： redirectAction方法向请求作用域设置了msg信息，查看是否显示了msg
跳转到站内action
主题：错误跳转
请求url：navigator!error.action  
生成错误
主题：@Action的使用已经Result的location绝对与相对的区别
使用注解@Action(value="/test/childTest")
请求url：/test/childTest.action  
注意：类仍然是NavigatorAction
next.jsp为绝对路径
主题：@Actions的使用
注解@Actions({ @Action(value="/test/action1"), @Action(value="/test/action2") })
请求
url：/test/action1.action
url：/test/action2.action
注意：类仍然是NavigatorAction
action1 action2


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>*.action</url-pattern> </filter-mapping>




struts2.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> <!--开发模式设置开始//--> <!--++++++++++++++++++++++++++++++++++++++++++++++++开发状态 --> <constant name="struts.devMode" value="true" /> <!-- 国际化资源重新加载 --> <constant name="struts.i18n.reload" value="true" /> <!-- 配置文件重新加载 --> <constant name="struts.configuration.xml.reload" value="true" /> <!-- convention类从新加载 --> <constant name="struts.convention.classes.reload" value="true" /> <!--++++++++++++++++++++++++++++++++++++++++++++++++开发模式结束 --> <!-- 主题 --> <constant name="struts.ui.theme" value="simple" /> <!-- 地区 --> <constant name="struts.locale" value="zh_CN" /> <!-- 国际化编码 --> <constant name="struts.i18n.encoding" value="UTF-8" /> <!-- 扩展--> <constant name="struts.action.extension" value="action,do,jsp" /> <!-- 启用动态方法调用 --> <constant name="struts.enable.DynamicMethodInvocation" value="true" /> <!-- 设置Struts 2是否允许在Action名中使用斜线 --> <constant name="struts.enable.SlashesInActionNames" value="false" /> <!-- 结果资源所在路径 --> <constant name="struts.convention.result.path" value="/"/> <!-- action后缀 --> <constant name="struts.convention.action.suffix" value="Action"/> <!-- 名称首字母小写 --> <constant name="struts.convention.action.name.lowercase" value="true"/> <!-- 分隔符 一个action名字的获取。比如为HelloWorldAction。按照配置，actionName为hello_world。 --> <constant name="struts.convention.action.name.separator" value="_"/> <!-- 禁用扫描 --> <constant name="struts.convention.action.disableScanning" value="false"/> <!-- 默认包 --> <constant name="struts.convention.default.parent.package" value="default"/> <!--确定搜索包的路径。只要是结尾为action的包都要搜索。basePackage按照默认不用配置，如果配置，只会找以此配置开头的包。locators及locators.basePackage都是一组以逗号分割的字符串。 --> <constant name="struts.convention.package.locators" value="actions"/> <!-- 禁用包搜索 --> <constant name="struts.convention.package.locators.disable" value="false"/> <!-- 基于什么包 --> <constant name="struts.convention.package.locators.basePackage" value="com.sunflower.actions"/> <!-- 排除的包 --> <constant name="struts.convention.exclude.packages" value="org.apache.struts.*,org.apache.struts2.*,org.springframework.web.struts.*,org.springframework.web.struts2.*,org.hibernate.*"/> <!-- 包含的包 --> <!-- 包括的jar,一般用于大型项目，其action一般打包成jar --> <constant name="struts.convention.action.includeJars" value="" /> <!-- 结果类型 --> <constant name="struts.convention.relative.result.types" value="dispatcher,freemarker"/> <!-- 如果此值设为true，如果一个action的命名空间为/login，名称为HelloWorldAction。result返回值是success，默认会找到/WEB-INF/pages/login/hello_world.jsp（如果有hello_world_success.jsp就找这个文件，连接符“_”是在<constant name="struts.convention.action.name.separator" value="_"/>中配置的）。如果有一个action的result返回值是“error”，就会找/WEB-INF/pages /login/hello_world_error.jsp。 如果此值设为false，如果一个action的命名空间为/login，名称为HelloWorldAction。result返回值是success，默认会找到/WEB- INF/pages/login/hello_world/index.jsp（如果有success.jsp就找这个文件）。如果有一个action的result返回值是“error”，就会找/WEB-INF/pages /login/hello_world/error.jsp。 --> <constant name="struts.convention.result.flatLayout" value="true"/> <constant name="struts.convention.action.mapAllMatches" value="false"/> <!-- 检查是否实现action --> <constant name="struts.convention.action.checkImplementsAction" value="true"/> <constant name="struts.mapper.alwaysSelectFullNamespace" value="false"/> <constant name="struts.convention.redirect.to.slash" value="true"/> <package name="default" extends="struts-default"> <interceptors> <interceptor-stack name="defaultStack"> <interceptor-ref name="exception" /> <interceptor-ref name="servletConfig" /> <interceptor-ref name="actionMappingParams" /> <interceptor-ref name="staticParams" /> <interceptor-ref name="params" /> </interceptor-stack> </interceptors> </package> </struts>




NavigatorAction源码



package com.sunflower.actions; import org.apache.struts2.convention.annotation.Action; import org.apache.struts2.convention.annotation.Actions; import org.apache.struts2.convention.annotation.Result; import org.apache.struts2.convention.annotation.Results; import com.opensymphony.xwork2.ActionContext; @Results( { @Result(name = "next", location = "/next.jsp", type = "dispatcher"), @Result(name = "error", location = "error.jsp", type = "dispatcher"), @Result(name = "redirectAction", location = "./child/child", type = "redirectAction"), @Result(name = "redirect", location = "http://sunflowers.iteye.com", type = "redirect") }) public class NavigatorAction { private String actionName; public void setActionName(String actionName) { this.actionName = actionName; } public String index() { outputMsg("method:index"); return "next"; } public String execute() { outputMsg("method:execute,no index method"); return "next"; } public String error() { try { throw new Exception(); } catch (Exception e) { outputMsg(e); return "error"; } } public String redirect() { System.out.println("重定向：rediret"); return "redirect"; } public String redirectAction() { outputMsg("navigatorAction 跳转而来，原地址是navigator!redirectAction.action，请查看地址栏"); return "redirectAction"; } @Action(value = "/test/childTest") public String action() { outputMsg("@action ---method:action"); return "next"; } @Actions( { @Action(value = "/test/action1"), @Action(value = "/test/action2") }) public String actions() { outputMsg("@actions ---method:actions,action=" + actionName); return "next"; } private void outputMsg(Object msg) { System.out.println(msg); ActionContext.getContext().put("msg", msg); } }
 



ChildAction源码



package com.sunflower.actions.child; import org.apache.struts2.convention.annotation.Result; import org.apache.struts2.convention.annotation.Results; @Results( { @Result(name = "next", location = "next.jsp", type = "dispatcher")}) public class ChildAction { public String execute() { System.out.println("childAction 默认方法执行"); return "next"; } }


index.jsp源码
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>struts2 convention测试</title> <style> * { line-height: 2em; } a:visited,a:hover,a:active,a:link { color: #00f; } </style> </head> <body> 后台Action&nbsp; <ul class="horizontal"> <li>com.sunflower.actions.NavigatorAction</li> <li>com.sunflower.actions.child.ChildAction</li> </ul> 页面资源&nbsp; <ul class="horizontal"> <li>error.jsp</li> <li>index.jsp</li> <li>next.jsp</li> <li>child/next.jsp</li> </ul> <ul> <li>主题：确认action内默认执行方法是execute还是index<br /> 请求url：navigator.action&nbsp;&nbsp;<br /> 类型：dispatcher <br /> 方法：execute或index <br /> <a href="./navigator.action">执行默认方法</a></li> <li>主题：测试如何跳转到站外<br /> 请求url：navigator!redirect.action&nbsp;&nbsp; <br /> 类型：redirect（旧版本使用ServletRedirectResult.class） <br /> 方法：redirect <br /> <a href="./navigator!redirect.action">跳转到站外</a></li> <li>主题：测试redirectAction、basePackage内子包action的映射、以及参数传递<br /> 请求url：navigator!redirectAction.action&nbsp;&nbsp; <br /> 类型：redirectAction （旧版本使用ServeltActionRedirectResult.class） <br /> 方法：redirectAction <br /> location：child/child(basePackage=com.sunflower.actions,this&nbsp;package=com.sunflower.actions.child) <br /> <font color="red">注意</font><br /> 1：ChildAction内的execute方法返回指向location="next.jsp"，查看结果页面next.jsp是根目录资源还是/child/next.jsp资源 <br /> 2： redirectAction方法向请求作用域设置了msg信息，查看是否显示了msg <br /> <a href="./navigator!redirectAction.action">跳转到站内action</a></li> <li>主题：错误跳转<br /> 请求url：navigator!error.action&nbsp;&nbsp; <br /> <a href="./navigator!error.action">生成错误</a></li> <li>主题：@Action的使用已经Result的location绝对与相对的区别<br /> 使用注解@Action(value="/test/childTest") <br /> 请求url：/test/childTest.action&nbsp;&nbsp; <br /> <font color="red">注意</font>：类仍然是NavigatorAction <br /> <a href="./test/childTest.action">next.jsp为绝对路径</a></li> <li>主题：@Actions的使用<br /> 注解@Actions({ @Action(value="/test/actions1"), @Action(value="/test/actions2") })<br /> 请求<br /> url：/test/action1.action <br /> url：/test/action2.action <br /> <font color="red">注意</font>：类仍然是NavigatorAction <br /> <a href="./test/action1.action?actionName=action1">action1</a>&nbsp;<a href="./test/action2.action?actionName=action2">action2</a></li> </ul> </body> </html>




next.jsp源码



<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>Insert title here</title><style> *{ line-height:3em; } </style> </head> <body> <h1>struts2 &nbsp;&nbsp;&nbsp;convention插件使用测试</h1> 测试信息 <br /> ${msg} <br /> <a href="#" onclick="window.history.go(-1);return false;">返回</a> </body> </html>




child/next.jsp源码



<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>Insert title here</title><style> *{ line-height:3em; } </style> </head> <body> child/next.jsp:{msg} </body> </html>