关于Apache betwixt组件的使用

最近研究了一下公司的底层框架的实现，发现公司对自定义的XML转换为javabean使用了apache betwixt组件，于是乎，就研究了一下，发现这个组件挺强大的。
环境准备：
必不可少的四个jar包
commons-betwixt.jar
commons-degester.jar
commons-collections.jar
commons-beanutils.jar
这里简单的例子就直接去apache的官网上看吧，这里介绍一下实战型复杂的用法.
以下是三个javaBean的代码：

public class SysCfgModule implements Serializable {

	public SysCfgModule()
	{
		requests=new ArrayList();
	}

	public List getRequests() {
		return requests;
	}

	//一定要有这个add方法，否则会抱警告，无法创建java.util.list对象，因为我们是采用的add方法，将xml中的单个request添加到requests中
	public void addRequest(SysCfgRequest request)
    {
        requests.add(request);
    }

	public String getMessageKey() {
		return messageKey;
	}

	public void setMessageKey(String messageKey) {
		this.messageKey = messageKey;
	}

	public String getUrlPrefix() {
		return urlPrefix;
	}

	public void setUrlPrefix(String urlPrefix) {
		this.urlPrefix = urlPrefix;
	}

	public String getRoles() {
		return roles;
	}

	public void setRoles(String roles) {
		this.roles = roles;
	}

	public String getDefaultValidator() {
		return defaultValidator;
	}

	public void setDefaultValidator(String
			defaultValidator) {
		this.defaultValidator = defaultValidator;
	}

	private static Log logger = LogFactory.getLog(SysCfgModule.class);
	private String messageKey;
	private String urlPrefix;
	private String roles;
	private String defaultValidator;
	private List requests;

}

public class SysConfigs {
	//这里面不要对addModule重载，否则会有问题。
	public void addModule(SysCfgModule newModule) throws Exception {
		// System.out.println(newModule);
		System.out.println("1111");
		System.out.println(newModule.getDefaultValidator());
		System.out.println(newModule.getRequests().size());
	}

	public void addModule() throws Exception {
		System.out.println("-------------");
	}

//	public void addModule(String type) throws Exception {
//		System.out.println("hello ");
//		System.out.println(type);
//	}



}

public class SysCfgRequest {
	private String path;
	private String validatorParameter;
	private String defaultValidator;

	public String getPath() {
		return path;
	}

	public void setPath(String path) {
		this.path = path;
	}

	public String getValidatorParameter() {
		return validatorParameter;
	}

	public void setValidatorParameter(String validatorParameter) {
		this.validatorParameter = validatorParameter;
	}

	public String getDefaultValidator() {
		return defaultValidator;
	}

	public void setDefaultValidator(String defaultValidator) {
		this.defaultValidator = defaultValidator;
	}

}

然后再看我们的design.xml是如何定义的：

<configs xmlns="http://www.example.org/design-config" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://www.example.org/design-config ../../design.xsd ">
	<module messageKey="km-answer:home.nav.kmAnswer" urlPrefix="/km/answer/"
		defaultValidator="roleValidator(role=ROLE_KMANSWER_DEFAULT)">
		<request
			path="km_doc_template/kmDocTemplate*"
			validatorParameter="recid=fdId,model=com.landray.kmss.km.doc.model.KmDocTemplate,adminRoleName=ROLE_KMDOC_CATEGORY_MAINTAINER">
		</request>
	</module>
</configs>

相信从这个XML我们就大概能看的出，这个XML和那三个对象的封装关系了吧，然后我们需要指定className+.betwixt文件，这是因为我们需要自定义封装。
一定要注意，这个className一定是我们需要映射的的javeBean的类名，SysCfgRequest.betwixt
下面贴出文件的如何定义：
SysConfigs.betwixt

<?xml version="1.0" encoding="UTF-8"?>
<info primitiveTypes="attribute">
	<element name="configs">
		<element
			name="module" property="modules"/>
				<addDefaults />
	</element>
</info>

SysCfgModule.betwixt

<?xml version="1.0" encoding="UTF-8"?>
<info primitiveTypes="attribute">
	<element name="module">
	    <element name="request" property="requests"/>
		<addDefaults />
	</element>
</info>

SysCfgRequest.betwixt

<?xml version="1.0" encoding="UTF-8"?>
<info primitiveTypes="attribute">
	<element name="request">
		<element
			name="query"
			property="querys" />
		<addDefaults />
	</element>
</info>

然后是如何去调用：

public static void paseXmlUseApacheComponent() {

		BeanReader reader = new BeanReader();
		try {
			reader.registerBeanClass(SysConfigs.class);
			reader.getXMLIntrospector().getConfiguration()
					.setAttributesForPrimitives(false);
			SysConfigs p = (SysConfigs) reader.parse(Thread.currentThread()
					.getContextClassLoader()
					.getSystemResourceAsStream(("design.xml")));
			System.out.println(p);
			// System.out.println(p.getType());
		} catch (Exception e) {
			e.printStackTrace();
		}

	}

我总结的几个小小的使用心得：

1：例如在sysConfig中需要添加sysCfgModule对象，那么我们在他们各自对应的element中所指定的名字都要一至,例如在sysCfgModule.betwixt中element叫“module”,那么在sysConfigs.betwixt也应该叫"module",必须跟add后面的名字保持一致，否则它找不到
2:值得注意的是不要去重载，这个add方法，否则会有问题。
3：因为javaBean默认是使用set作为默认的赋值方法，如果需要使用add,则需要在.betwixt中使用<addDefaults />指定。
4：在.betwixt文件中property="****"，不是必须的，他的意思是对应类中的某个属性，例如property=requests,如果没有这个，那么requests这个列表中不会添加元素。
*