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>