struts2基于注解的action

使用注解来配置Action的最大好处就是可以实现零配置，但是事务都是有利有弊的，使用方便，维护起来就没那么方便了。

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

虽说是零配置的，但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>

　　

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;
}

public String getLoginName() {
return loginName;
}
public void setLoginName(String loginName) {
this.loginName = loginName;
}
public String getPassword() {
return password;
}
public void setPassword(String password) {
this.password= password;
}

}

这样就完成了一个基于注解的action配置。

总结常用的注解如下：

Namespace：指定命名空间。

ParentPackage：指定父包。

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

Results：“Result”注解列表

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

Action：指定Action的访问URL。

Actions：“Action”注解列表。

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

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

InterceptorRef：拦截器引用。

InterceptorRefs：拦截器引用组。

实际上struts2中最主要的概念就是package、action以及Interceptor等等概念，所以只要明白这些注解就可以了。

如果希望使用struts2的注解功能，必须使用一个包 struts2-convention-plugin-2.1.8.1.jar，我使用的环境是struts2.1.8.1。如果你使用了不同的版本，找名字就行。

在以上所述的jar文件中定义了一系列的注解，其中比较主要的是：

@ParentPackage，这个注解对应了xml文件中的package节点，它只有一个属性叫value，其实就是package的name属性；
@Namespace，命名空间，也就是xml文件中<package>的namespace属性；
@Action，这个注解对应<action>节点。这个注解可以应用于action类上，也可以应用于方法上。这个注解中有几个属性：
　　value()，表示action的URL，也就是<action>节点中的name属性；
　　results()，表示action的多个result；这个属性是一个数组属性，因此可以定义多个Result；
　　interceptorRefs()，表示action的多个拦截器。这个属性也是一个数组属性，因此可以定义多个拦截器；
　　params()，这是一个String类型的数组，它按照name/value的形式组织，是传给action的参数；
　　exceptionMappings()，这是异常属性，它是一个ExceptionMapping的数组属性，表示action的异常，在使用时必须引用相应的拦截器；
@Result，这个注解对应了<result>节点。这个注解只能应用于action类上。这个注解中也有几个属性：
　　name()，表示action方法的返回值，也就是<result>节点的name属性，默认情况下是【success】；
　　location()，表示view层文件的位置，可以是相对路径，也可以是绝对路径；
　　type()，是action的类型，比如redirect；
　　params()，是一个String数组。也是以name/value形式传送给result的参数；

实际上，struts2中的主要注解就是这些，当然了，还有上面提到的@interceptorRef和@exceptionMapping；基本上，掌握了这些注解就可以了。

但是如果想让这些注解真正工作，必须在配置文件增加几个常量的定义：

struts.convention.default.parent.package：这个常量表示缺省的包名是什么，因为在实际应用中，我们常常定义一个缺省的包，这个包中定义了一大堆的拦截器等等，然后其他的包继承自这个包。这个常量可以配也可以不配；

struts.convention.package.locators：这个常量表示你的action类的java包的包名的后缀是啥：比如action。这个常量也可以不配；

struts.convention.package.locators.basePackage：这个常量表示你的action类的java包package的名字是啥；这个常量也可以不配；

以上三个常量都是辅助作用的，为了让注解真正的工作，必须在配置文件中增加<package>节点的配置，至少是<package name="myPackage" extends="struts-default" />，这样注解就可以使用了。