struts2注解 零注释

要使用注解方式，我们必须添加一个额外包：struts2-convention-plugin-2.x.x.jar。

配置web.xml

<filter><filter-name>struts2</filter-name><filter-class>org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter</filter-class><init-param><param-name>actionPackages</param-name><param-value>com.test.action</param-value></init-param></filter><filter-mapping><filter-name>struts2</filter-name><url-pattern>/*</url-pattern></filter-mapping>

虽说是零配置的，但struts.xml还是少不了的，配置如下：

<?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE struts PUBLIC     "-//Apache Software Foundation//DTD Struts Configuration 2.1.7//EN"     "http://struts.apache.org/dtds/struts-2.1.7.dtd">    <struts>       <!-- 请求参数的编码方式-->     <constant name="struts.i18n.encoding" value="UTF-8"/>     <!-- 指定被struts2处理的请求后缀类型。多个用逗号隔开-->     <constant name="struts.action.extension" value="action,do,htm"/>     <!-- 当struts.xml改动后，是否重新加载。默认值为false(生产环境下使用),开发阶段最好打开  -->     <constant name="struts.configuration.xml.reload" value="true"/>     <!-- 是否使用struts的开发模式。开发模式会有更多的调试信息。默认值为false(生产环境下使用),开发阶段最好打开  -->     <constant name="struts.devMode" value="false"/>       <!-- 设置浏览器是否缓存静态内容。默认值为true(生产环境下使用),开发阶段最好关闭  -->     <constant name="struts.serve.static.browserCache" value="false" />     <!-- 指定由spring负责action对象的创建        <constant name="struts.objectFactory" value="spring" />     -->     <!-- 是否开启动态方法调用-->     <constant name="struts.enable.DynamicMethodInvocation" value="false"/> </struts> 

总结常用的注解如下：

 

Namespace：指定命名空间。

ParentPackage：指定父包。

Result：提供了Action结果的映射。（一个结果的映射）

Results：“Result”注解列表

ResultPath：指定结果页面的基路径。

Action：指定Action的访问URL。

Actions：“Action”注解列表。

ExceptionMapping：指定异常映射。（映射一个声明异常）

ExceptionMappings：一级声明异常的数组。

InterceptorRef：拦截器引用。

InterceptorRefs：拦截器引用组。

示例：action类的注解

 

package com.tjcyjd.web.action;      import org.apache.struts2.convention.annotation.Action;   import org.apache.struts2.convention.annotation.ExceptionMapping;   import org.apache.struts2.convention.annotation.ExceptionMappings;   import org.apache.struts2.convention.annotation.Namespace;   import org.apache.struts2.convention.annotation.ParentPackage;   import org.apache.struts2.convention.annotation.Result;   import org.apache.struts2.convention.annotation.Results;      import com.opensymphony.xwork2.ActionSupport;      /**  * Struts2基于注解的Action配置 *   */   @ParentPackage("struts-default") @Namespace("/annotation_test") @Results( { @Result(name = "success", location = "/main.jsp"),         @Result(name = "error", location = "/error.jsp") }) @ExceptionMappings( { @ExceptionMapping(exception = "java.lange.RuntimeException", result = "error") }) public class LoginAction extends ActionSupport {     private static final long serialVersionUID = 2730268055700929183L;      private String loginName;       private String password;          @Action("login") //或者写成  @Action(value = "login")      public String login() throws Exception {              if ("yjd".equals(loginName) && "yjd".equals(password)) {               return SUCCESS;           } else {               return ERROR;           }       }       @Action(value = "add", results = { @Result(name = "success", location = "/index.jsp") })       public String add() throws Exception {           return SUCCESS;       }   } 

部分注解说明

 一、Convention的Annotation
1）与Action相关的两个Annotation是@Action 和@Actions
2）@Action中可指定一个value属性。类似于指定<action name=””/>属性值
3）@Action中还可以指定一个params属性，该属性是一个字符串数组，用于该Acion指定的参数名和参数值。params属性应遵守如下格式：{“name1”,”value1”,”name2”,”value2”}
4）@Actions 也用于修饰Action类里的方法，用于将该方法映射到多个URL.@Actions用于组织多个@Action.因此它可将一个方法映射成多个逻辑Action。

二、与Result配置相关的Annotation
1）@ResultPath @Result 和Results
2）@Results用于组织多个@Result因此它只需指定一个value属性值，该value属性值为多个@Result
3）@Result相当于struts.xml文件中的<result/>元素。使用@Result必须指定一个name属性，相当于<result name=””/>另外，它还有几个可选的属性。
     ☆ type 相当于<result type=””/>指定返回视图资源的类型
     ☆ location 相当于<result>…..</result>中间部分，用于指定实际视图位置
     ☆ params：该属性相当于<result/>元素里多个<param../>子元素的作用，用于为该Result指定参数值。该属性应满足{“name1”,”value1”,”name2”,”value2”}格式
4）@Result有以下两种用法
1.Action级的Result映射：以@Actions组合多个@Action后修饰的Action类。这种Result映射对该Action里的所有方法都有效。
2.方法级Result映射：将多个@Result组成数组后作为@Action的results属性值。这种Result映射仅对被修饰的方法有效。
5）@ResultPath则用于修饰包和Action类，用于改变被修饰Action所对应的物理视图资源的根路径。举例说：默认情况下，Convention都会到WEB-INF/content路径下找物理视图资源，一旦我们使用@ResultPath("/view")修饰该Action，系统将回到view目录下寻找物理视图资源。

三、与包和命名空间相关的Annotation：
@Namespace：修饰Action类或其所在的包。该Annotation中指定一个value属性值，用于指定被修饰的Action所在的命名空间
@Namespaces：修饰Action类或其所在的包，用于组合多个@Namespace
@ParentPackage: 用于指定被修饰的Action所在包的父包。

四、与异常处理相关的Annotation
@ExceptionMappings 用于组织多个@ExceptionMapping，因此它只需指定一个value属性值，该value属性值为多个@ExceptionMapping。
@ExceptionMapping 用于定义异常类和物理视图之间的对应关系，也相当于struts.xml文件里<exception-mapping../>元素的作用 使用时，必须注意以下两个属性：
exception: 用于指定异常类
result：用于指定逻辑视图
@ExceptionMpping有如下两种用法
Action级的异常定义：以@ExceptionMappings组合多个@ExceptionMapping后修饰的Action类。这种异常定义对Action中的所有方法有效
方法级的异常定义：将多个@ExceptionMapping组成数组后作为@Action的exceptionMappings属性值，这种异常定义仅对被修饰的方法有效。

五、与拦截器配置相关的Annotation
与拦截器配置的Annotation有@InterceptorRef、@InterceptorRefs和@DefaultInterceptorRef
@InterceptorRefs用于组织多个@InterceptorRef，因此它只需要指定一个value属性值，该value属性值为多个@InterceptorRef
@InterceptorRef用于为指定Action引用lanjieq或者是拦截器栈。也就相当于strut.xml中位于<action../>元素内部的<interceptor-ref../>子元素的作用。使用@InterceptorRefAnnotation时，必须制定一个value属性，用于指定所引用的拦截器或拦截器栈的名字。相当于<interceptor-ref../>子元素里name属性的作用。