使用注解来配置Action可以实现零配置,零配置将从基于纯XML的配置转化为基于注解的配置。使用注解,可以在大多数情况下避免使用struts.xml文件来进行配置。
struts2框架提供了四个与Action相关的注解类型,分别为ParentPackage、Namespace、Result和Action。
ParentPackage:ParentPackage注解用于指定Action所在的包要继承的父包。该注解只有一个value参数。用于指定要继承的父包。示例:
使用ParentPackage注解,其value值为mypackage,表示所在的Action需要继承mypackage包,
@ParentPackage(value="mypackage") public class UserAction extends ActionSupport{ }
如果注解中只有一个value参数值,或者其他参数值都使用默认值时,则可以对value参数设置进行简写,比如上述的代码:
@ParentPackage("mypackage") public class UserAction extends ActionSupport{ }
把struts2-convention-pligin-2.x.x.jar包导入到web应用中,才能在Action类中使用注解。
Namespace:Namespace注解用于指定Action所在的包的命名空间。该注解只有一个value参数,用于指定ACtion所属于的命名空间。
当使用Namespace注解时,在为命名空间取名需要使用斜杠(/)开头。
使用Namespace注解,指定其Action所在的包的命名空间为/user:
@Namespace("/user") public class UserAction extends ActionSupport{ }
Result:Result注解用于定义一个Result映射,该注解包含四个参数,
1)name:可选参数,用于指定Result的逻辑名,默认值为success
2)location:必选参数,用于指定Result对应资源的URL
3)type:可选参数,用于指定Result的类型,默认值为NullResult.class
4)params:可选参数,用于为Result指定要传递的参数,格式为:{key1,value1,key2,value2,...}
如果type参数的值为NullResult.class,那么struts2框架在解析Result配置时,会使用默认的结果类型(即ServletDispatcherResult)来替换NullResult。
@Result(name="login",location="/login.jsp",params={},type="dispatcher") public class UserAction extends ActionSupport{ }
Action:Action注解对应于struts.xml文件中的action元素。该注解可用于Action类上,也可用于方法上。这个注解包含一下的几个属性:
1)value:可选参数,表示Action的名字
2)results:可选参数,表示Action的多个Result映射。该属性用于定义一组Result映射
3)interceptorRefs:可选参数,表示Action的多个拦截器。该属性用于定义一组拦截器
4)params:可选参数,表示传递给Action的参数,格式为{key1,value1,key2,value2,...}
5)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 UserAction extends ActionSupport{ }