关于Apache betwixt组件的使用

lx86

最近研究了一下公司的底层框架的实现，发现公司对自定义的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这个列表中不会添加元素。
*