使用注解的好处:
- 可以完全省略struts.xml的配置。
- 代码看起来更加简洁,而且使每一个映射更加独立。
- 在相对较大的项目里推荐使用注解的方式,因为大型项目中各种映射关系很多,而且还要包括各种拦截器,异常等等的配置,如果都写在struts.xml里就会显得很乱。但是在一些中小型的项目里推荐使用struts.xml。
注意:当注解和struts.xml都存在的时候,应当以注解为准。
把struts2-convention-pligin-2.x.x.jar包导入到web应用中,才能在Action类中使用注解。
Struts2框架提供了四个与Action相关的注解类型,分别为ParentPackage、Namespace、Result和Action。
- ParentPackage
- 用于指定Action所在的包要继承的父包。
- Namespace
- 用于指定Action所在的包的命名空间。
- Result
- 用于定义一个Result映射
- Action
- 对应于struts.xml文件中的action元素。该注解可用于Action类上,也可用于方法上。
ParentPackage
用于指定要继承的父包。使用ParentPackage注解,其value值为testpackage,表示所在的Action需要继承testpackage包。
@ParentPackage(value="testpackage")
public class TestAction extends ActionSupport{ }
Namespace
该注解只有一个value参数,用于指定ACtion所属于的命名空间。当使用Namespace注解时,在为命名空间取名需要使用斜杠(/)开头。
@Namespace("/test")
public class TestAction extends ActionSupport{ }
Result
Result注解用于定义一个Result映射,该注解包含四个参数。
- name:可选参数,用于指定Result的逻辑名,默认值为success
- location:必选参数,用于指定Result对应资源的URL
- type:可选参数,用于指定Result的类型,默认值为NullResult.class
- params:可选参数,用于为Result指定要传递的参数,格式为:{key1,value1,key2,value2,…}
@Result(name="login",location="/login.jsp",params={},type="dispatcher")
public class TestAction extends ActionSupport{ }
Action
该注解可用于Action类上,也可用于方法上。这个注解包含一下的几个属性:
- value:可选参数,表示Action的名字
- results:可选参数,表示Action的多个Result映射。该属性用于定义一组Result映射
- interceptorRefs:可选参数,表示Action的多个拦截器。该属性用于定义一组拦截器
- params:可选参数,表示传递给Action的参数,格式为{key1,value1,key2,value2,…}
- exceptionMappings:可选参数,指定Action的异常处理类,他是一个Exception-Mapping的数组属性
@Action{
value="user",
interceptorRefs = {
@InterceptorRefs(value="fileUpload",params={"maximumSize","1024000","allowedTypes",image/123}),
@InterceptorRefs(value = "basicStack")
},
results = {
@Result(name="success",location="success.jsp"),
@Result(name="login",location="login.jsp")
},
exceptionMappings = {
@ExceptionMapping(exception="java.lang.Exception",result="error")
}
}
public class TestAction extends ActionSupport{
}