首先是定义好我们要用的annotation,定之前,我们先确定了一个开发的基本标准,也就是一个action类需要包括针对一个业务对象操作的多个action方法,也就是说比如StudentAction,将会包括listStudent, removeStudent, editStudent, loadStudent, addStudent等多个action方法,我想这个粒度是比较合适,action类不会太多,也不会将太多的action方法堆积到一个action类中。
我定义了9个annotation,包括:
Package:定义在Action类上,包括namespace属性,parent属性。系统启动时搜索指定类路径下所有被Package标志过的类,作为Action类,并读取相关的namespace和parent属性。当然这样做也有一个缺点,package和类的层次绑定死了,如果想要两个不同的action方法分别在两个不同的类中,但需要在同一个package下时,就显得不够灵活,但我想这样的情况应该比较少,所以没有多考虑。
Action:定义在Action类的相关Action方法上,有name属性和param数组属性。这里定义的name和所在类的Package中定义的namespace组成call该action的url。
ActionResult和ActionResults:用来定义该Action的返回结果,作用在方法上。ActionResults用在定义一个Action有多个ActionResult的时候,ActionResult包括name属性,type属性,value属性(即返回的jsp路径),param属性数组。
ActionInterceptor和ActionInterceptors:用来定义该Action的拦截器,作用在方法上。ActionInterceptors用在定义一个Action有多个ActionInterceptor的时候,ActionInterceptor包括value属性(该action引用的拦截器的名字),param属性数组。
ActionExceptionMapping和ActionExceptionMappings:用来定义该Actiond的Exception mapping,作用在方法上。ActionExceptionMappings用在定义一个Action有多个ActionExceptionMapping的时候,ActionExceptionMapping包括expceptionClass属性,result属性。
Param:用来定义以上annotation配置中的参数配置。
以上annotation对象的属性以及配置都是和在xml配置文件中的相关元素的属性以及配置有对应关系的,参考xml配置方式会很快明白以上annotation每个属性的意义。
我定义了9个annotation,包括:
Package:定义在Action类上,包括namespace属性,parent属性。系统启动时搜索指定类路径下所有被Package标志过的类,作为Action类,并读取相关的namespace和parent属性。当然这样做也有一个缺点,package和类的层次绑定死了,如果想要两个不同的action方法分别在两个不同的类中,但需要在同一个package下时,就显得不够灵活,但我想这样的情况应该比较少,所以没有多考虑。
@Target({ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Inherited
@Documented
public @interface Package {
//url名字空间
String namespace();
//父package
String parent() default "default";
}
Action:定义在Action类的相关Action方法上,有name属性和param数组属性。这里定义的name和所在类的Package中定义的namespace组成call该action的url。
@Target({ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface Action {
//action name
String name();
//参数
Param[] param() default {};
}
ActionResult和ActionResults:用来定义该Action的返回结果,作用在方法上。ActionResults用在定义一个Action有多个ActionResult的时候,ActionResult包括name属性,type属性,value属性(即返回的jsp路径),param属性数组。
@Target({ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface ActionResult {
//result name
String name() default Action.SUCCESS;
//类型
Class type() default NullResult.class;
//值,jsp路径
String value();
//参数
Param[] param() default {};
}
@Target({ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface ActionResults {
ActionResult[] value();
}
ActionInterceptor和ActionInterceptors:用来定义该Action的拦截器,作用在方法上。ActionInterceptors用在定义一个Action有多个ActionInterceptor的时候,ActionInterceptor包括value属性(该action引用的拦截器的名字),param属性数组。
@Target({ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface ActionInterceptor {
//ref's interceptor name
String value();
Param[] param() default {};
}
@Target({ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface ActionInterceptors {
ActionInterceptor[] value();
}
ActionExceptionMapping和ActionExceptionMappings:用来定义该Actiond的Exception mapping,作用在方法上。ActionExceptionMappings用在定义一个Action有多个ActionExceptionMapping的时候,ActionExceptionMapping包括expceptionClass属性,result属性。
@Target({ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface ActionExceptionMapping {
//class
Class exceptionClass();
//result mapping
String result();
//参数
Param[] param() default {};
}
@Target({ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface ActionExceptionMappings {
ActionExceptionMapping[] value();
}
Param:用来定义以上annotation配置中的参数配置。
@Target({ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface Param {
//参数名称
String name();
//参数内容
String value();
}
以上annotation对象的属性以及配置都是和在xml配置文件中的相关元素的属性以及配置有对应关系的,参考xml配置方式会很快明白以上annotation每个属性的意义。