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关键部分

   

   

     <filter>
         <filter-name>struts2filter-name>
         <filter-class>
             org.apache.struts2.dispatcher.FilterDispatcher
         filter-class>
     filter>
     <filter-mapping>
         <filter-name>struts2filter-name>
         <url-pattern>*.actionurl-pattern>
     filter-mapping>

 

 

struts2.xml配置如下

 

 

 xml version="1.0" encoding="UTF-8" ?>

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

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

     <constant name="struts.enable.SlashesInActionNames" value="false" />

     <constant name="struts.convention.result.path" value="/"/>

     <constant name="struts.convention.action.suffix" value="Action"/>

     <constant name="struts.convention.action.name.lowercase" value="true"/>

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

     <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.*"/>


     <constant name="struts.convention.action.includeJars" value="" />

     <constant name="struts.convention.relative.result.types" value="dispatcher,freemarker"/>

     <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"%>
 >
 <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
 <ul class="horizontal">
     <li>com.sunflower.actions.NavigatorActionli>
     <li>com.sunflower.actions.child.ChildActionli>
 ul>
 页面资源
 <ul class="horizontal">
     <li>error.jspli>
     <li>index.jspli>
     <li>next.jspli>
     <li>child/next.jspli>
 ul>
 <ul>
     <li>主题：确认action内默认执行方法是execute还是index<br />
     请求url：navigator.action  <br />
     类型：dispatcher <br />
     方法：execute或index <br />
     <a href="./navigator.action">执行默认方法a>li>
     <li>主题：测试如何跳转到站外<br />
     请求url：navigator!redirect.action   <br />
     类型：redirect（旧版本使用ServletRedirectResult.class） <br />
     方法：redirect <br />
     <a href="./navigator!redirect.action">跳转到站外a>li>
     <li>主题：测试redirectAction、basePackage内子包action的映射、以及参数传递<br />
     请求url：navigator!redirectAction.action   <br />
     类型：redirectAction （旧版本使用ServeltActionRedirectResult.class） <br />
     方法：redirectAction <br />
     location：child/child(basePackage=com.sunflower.actions,this 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">跳转到站内actiona>li>
     <li>主题：错误跳转<br />
     请求url：navigator!error.action   <br />
     <a href="./navigator!error.action">生成错误a>li>
     <li>主题：@Action的使用已经Result的location绝对与相对的区别<br />
     使用注解@Action(value="/test/childTest") <br />
     请求url：/test/childTest.action   <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">action1a> <a
         href="./test/action2.action?actionName=action2">action2a>li>
 ul>
 body>
 html>

 

 

 next.jsp源码

 

 <%@ page language="java" contentType="text/html; charset=UTF-8"
     pageEncoding="UTF-8"%>
 >
 <html>
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>Insert title heretitle><style>
 *{
 line-height:3em;
 }
 style>
 head>
 <body>
 <h1>struts2    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"%>
 >
 <html>
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>Insert title heretitle><style>
 *{
 line-height:3em;
 }
 style>
 head>
 <body>
 child/next.jsp:{msg}
 body>
 html>