spring 扩展

Spring的可扩展点做得比hibernate好多了，参考文档上就可以找到扩展spring配置文件的方法。利用在类路径的META-INF目录下加入spring.handlers和spring.schemas两个文件来作为扩展的入口。
   
我的思路是这样的，通过在一个spring总的配置文件中，比如applicationContext.xml中，加入一段我自定义的xml标签，在这个标签上定义我需要注册的spring的service bean在什么类路径下。然后spring在启动时，读取到该标签上定义的类路径，寻找该类路径下被我用annotation标注过的类，将该类注册到spring容器中。

第一步，定义标识service bean的annotation：
该annotation其实只需要一个属性，该service bean注册到spring中的id，所以我建立了如下的名字叫Bean的annotation类：

@Target({ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface Bean {
    //获取bean id
    String id();
}

@Target({ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface Bean {
	//获取bean id
	String id();
}

该annotation只能定义在类或者接口上，只有一个属性id，必填。用它标识后的service bean如下：

@Bean(id="sample.lesson.student")
public class StudentServiceBean implements IStudent {

@Bean(id="sample.lesson.student")
public class StudentServiceBean implements IStudent {

第二步，扩展spring xml配置，定义service bean所在的目录：
前面已经说过，我们需要在applicationContext.xml这个总配置文件中定义service bean所在的目录。于是我在applicationContext.xml加入如下的tag：

<sa:annotation-autoload >
    <sa:package>sample/service/lesson </sa:package>
<sa:package>sample/service/student</sa:package>
</sa:annotation-autoload>

<sa:annotation-autoload >
	<sa:package>sample/service/lesson </sa:package>
<sa:package>sample/service/student</sa:package>
</sa:annotation-autoload>

加完后，eclipse的schemas校验功能已经告诉我们，出错误了。因为spring中并没有sa:annotation-autolaod和sa:package这样的标签，所以我们需要扩展spring校验用的schemas。扩展的方法就是在applicationContext文件中的beans根节点加入对schemas定义的代码：

<beans xmlns="http://www.springframework.org/schema/beans"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:aop="http://www.springframework.org/schema/aop"
    xmlns:tx="http://www.springframework.org/schema/tx"
    xmlns:sa="http://leeon.iteye.com/context"
    xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.0.xsd
           http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-2.0.xsd
           http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-2.0.xsd
           http://leeon.iteye.com/context http://leeon.iteye.com/context.xsd">

<beans xmlns="http://www.springframework.org/schema/beans"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xmlns:aop="http://www.springframework.org/schema/aop"
	xmlns:tx="http://www.springframework.org/schema/tx"
	xmlns:sa="http://leeon.iteye.com/context"
	xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.0.xsd
           http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-2.0.xsd
           http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-2.0.xsd
           http://leeon.iteye.com/context http://leeon.iteye.com/context.xsd">

这段代码中，xmns:sa=http://leeon.iteye.com/context定义了xml tag的前缀是sa，而xsi:chemaLocation中定义的 http://leeon.iteye.com/context http://leeon.iteye.com/context.xsd指向了schemas xsd文件的位置。当然，不能让系统真的访问互联网去下载这个xsd了，可以通过在META-INF中创建的spring.handlers和spring.schemas文件类来定义schemas在本地类路径中的位置以及相关的handle这个schemas定义的xml tag的解析类，Spring加载时会通过这两个文件找到xsd和handler解析类的本地版本。

第三步，建立spring.handlers和spring.schemas以及相关的xsd和handler
于是在/META-INF中创建spring.schemas，内容如下：http\://leeon.iteye.com/context.xsd=leeon/extend/spring/context.xsd
这句话说明了真正校验我们自定义tag的xsd在leeon/extend/spring的类路径下
说明了位置后，我们就可以创建context.xsd，该xsd就是普通的校验xml用的xsd，不多做描述。可以参考以下代码：

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<xsd:schema xmlns="http://leeon.iteye.com/context" xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    targetNamespace="http://leeon.iteye.com/context" elementFormDefault="qualified" attributeFormDefault="unqualified">
    <xsd:annotation>
        <xsd:documentation>
            <![CDATA[
        XML Schema for the Spring-Annotation module, it enables the use of annotations to configure your Spring-Framework application
        ]]>
        </xsd:documentation>
    </xsd:annotation>
    <xsd:element name="annotation-autoload">
        <xsd:annotation>
            <xsd:documentation>
                <![CDATA[Enables the scanning of anotated classes in the classpath, the scanDirs attribute tells to scan all open directories in the classpath, and the jarMarkerFile enables you to tell the scanner to loog for a file named different from to.properties in the jar files.]]>
            </xsd:documentation>
        </xsd:annotation>
        <xsd:complexType>
            <xsd:sequence>
                <xsd:element name="package" type="xsd:string" minOccurs="0" maxOccurs="unbounded">
                    <xsd:annotation>
                        <xsd:documentation>
                            <![CDATA[defines that the scanner will only include files that match with this.]]>
                        </xsd:documentation>
                    </xsd:annotation>
                </xsd:element>
            </xsd:sequence>
            <xsd:attribute name="pattern" type="xsd:string" default=".*\.class" use="optional" />
        </xsd:complexType>
    </xsd:element>
</xsd:schema>

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<xsd:schema xmlns="http://leeon.iteye.com/context" xmlns:xsd="http://www.w3.org/2001/XMLSchema"
	targetNamespace="http://leeon.iteye.com/context" elementFormDefault="qualified" attributeFormDefault="unqualified">
	<xsd:annotation>
		<xsd:documentation>
			<![CDATA[
		XML Schema for the Spring-Annotation module, it enables the use of annotations to configure your Spring-Framework application
		]]>
		</xsd:documentation>
	</xsd:annotation>
	<xsd:element name="annotation-autoload">
		<xsd:annotation>
			<xsd:documentation>
				<![CDATA[Enables the scanning of anotated classes in the classpath, the scanDirs attribute tells to scan all open directories in the classpath, and the jarMarkerFile enables you to tell the scanner to loog for a file named different from to.properties in the jar files.]]>
			</xsd:documentation>
		</xsd:annotation>
		<xsd:complexType>
			<xsd:sequence>
				<xsd:element name="package" type="xsd:string" minOccurs="0" maxOccurs="unbounded">
					<xsd:annotation>
						<xsd:documentation>
							<![CDATA[defines that the scanner will only include files that match with this.]]>
						</xsd:documentation>
					</xsd:annotation>
				</xsd:element>
			</xsd:sequence>
			<xsd:attribute name="pattern" type="xsd:string" default=".*\.class" use="optional" />
		</xsd:complexType>
	</xsd:element>
</xsd:schema>

接下来创建spring.handlers，内容如下：http\://leeon.iteye.com/context=leeon.extend.spring.EnableAnnotationHandler，这句话说明了Handler处理类所在的类路径，是真正处理我们在xml定义的tag的handler类。

创建时必须继承org.springframework.beans.factory.xml.NamespaceHandlerSupport类。该类是一个抽象类，必须实现的方式就是init，在这个方法中，告诉spring容器，处理哪些tag，需要哪些BeanDefinitionParser，代码如下：

public class EnableAnnotationHandler extends NamespaceHandlerSupport {
    public void init() {
        registerBeanDefinitionParser("annotation-autoload",
new AnnotationAutoloadBeanDefinitionParser());
    }
}

public class EnableAnnotationHandler extends NamespaceHandlerSupport {
    public void init() {
        registerBeanDefinitionParser("annotation-autoload", 
new AnnotationAutoloadBeanDefinitionParser());
    }
}

这里就是告诉spring容器，初始化处理annotation-autoload这个的xml element时，使用AnnotationAutoloadBeanDefinitionParser，该Parser是一个实现了BeanDefinitionParser接口的类。

第四步，实现自定义的BeanDefinitionParser
BeanDefinitionParser接口中，必须实现的方法是parse方法。顾名思义，我们要在这个方法中解析自定义的xml element，然后拿到在xml定义的service bean所在的类路径，再将该路径下被@Bean注册过的类，注册到spring的容器中。

public BeanDefinition parse(Element element, ParserContext parserContext) {
}

public BeanDefinition parse(Element element, ParserContext parserContext) {
}

Parse的两个参数：
1. Element表示需要被我们解析的自定义的xml element对应的对象，这里对应的就是<sa:annotation-autoload>节点及其子节点。通过该对象我们可以获取我们配置的类路径，并搜索类路径，找到需要注册到spring容器中的类以及注册后的id。
2. ParserContext，BeanDefinitionParser的相关上下文环境，我们可以从这个参数中去到spring的类注册器，并进行spring bean的注册：

//从parserContext中获取bean注册器
BeanDefinitionRegistry bdr = parserContext.getRegistry();

//从创建一个spring bean的定义，并设定一下初始化值
//setBeanClass就是设定符合条件的service bean对应的class
final RootBeanDefinition rbd = new RootBeanDefinition();
rbd.setAbstract(false);
rbd.setBeanClass(c);
rbd.setSingleton(false);
rbd.setLazyInit(false);

//将spring bean的定义，通过id，注册到spring容器中
//这里的id就是从annotation中去到的service bean对应的spring bean id
bdr.registerBeanDefinition(id, rbd);

//从parserContext中获取bean注册器
BeanDefinitionRegistry bdr = parserContext.getRegistry();

//从创建一个spring bean的定义，并设定一下初始化值
//setBeanClass就是设定符合条件的service bean对应的class
final RootBeanDefinition rbd = new RootBeanDefinition();
rbd.setAbstract(false);
rbd.setBeanClass(c);
rbd.setSingleton(false);
rbd.setLazyInit(false);				

//将spring bean的定义，通过id，注册到spring容器中
//这里的id就是从annotation中去到的service bean对应的spring bean id
bdr.registerBeanDefinition(id, rbd);

另外，该方法虽然需要返回值，但也是可以返回null的。定义好这个AnnotationAutoloadBeanDefinitionParser后，将spring bean注册的xml代码移植到annotation上就大功告成。当spring启动解析到<sa:annotation-autoload>标签时，就会将处理的过程交给AnnotationAutoloadBeanDefinitionParser，有Parser里的parse方法来解析到service bean所在路径，搜索，获取id和class，最后加载完成。

首先是定义好我们要用的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";
}

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

@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();
}

@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();
}

@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();
}

@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();
}

@Target({ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface Param {
	//参数名称
	String name();
	//参数内容
	String value();
}

以上annotation对象的属性以及配置都是和在xml配置文件中的相关元素的属性以及配置有对应关系的，参考xml配置方式会很快明白以上annotation每个属性的意义。