打造0配置文件的SSH框架-7

    首先是定义好我们要用的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下时，就显得不够灵活，但我想这样的情况应该比较少，所以没有多考虑。

@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每个属性的意义。

评论

2 楼 leeon 2007-09-26  

默认用@package所在类的名字，反正这个name只在extends的时候用到
如果把这个annotation定义在package-info.java中，就用包的名字，应该也是唯一的

1 楼 allenBen 2007-09-25  

你好 
    你定义的@Package 里边没有name属性，那么对于标签里边对应的<package name=""/>属性你怎么设置呢？
    而且DTD里边是这么写的：
<!ATTLIST package
    name CDATA #REQUIRED
    extends CDATA #IMPLIED
    namespace CDATA #IMPLIED
    abstract CDATA #IMPLIED
    externalReferenceResolver NMTOKEN #IMPLIED
>
    name属性好像是REQUIRED的哦
谢谢