Jakarta Common Digester 应用
Jakarta Common Digester 应用
1 什么是 Common Digester
Jakarta Common Digester 是一套 XML to Object 的 API，它可以将XML文件转换为任意的Java对象，并且提供灵活的扩展接口。
2 原理
2.1 简单的例子
将以下 XML 文件构造成 ArrayList;
<?xml version="1.0" encoding="ISO8859_1"?>
<list>
<bean id="1111" description="abc"/>
<bean id="2222" description="bcd"/>
</list>
Bean 类
public class Bean
{
private String id;
private String description;
public void setId(String id)
{
this.id = id;
}
public String getId()
{
return id;
}
public void setDescription(String description)
{
this.description = description;
}
public String getDescription()
{
return description;
}
}
Digester digester = new Digester();
digester.addObjectCreate("list", ArrayList.class):
digester.addObjectCreate("list/bean" Bean.class);
digester.addSetProperties("list/bean");
digester.addSetNext("list/bean", "add");
[url=file://TODO:][/url]/*TODO: Load xml file as stream*/
InputStream is = null;
ArrayList list = (ArrayList) digester.parse(is);
2.2 Digester 的处理过程 (Rule, XPath, Object Stack)
首先为 Digester 指明处理规则， 每种处理规则都要匹配 XPath，如下：
digester.addObjectCreate("list", ArrayList.class):
digester.addObjectCreate("list/bean" Bean.class);
digester.addSetProperties("list/bean");
digester.addSetNext("list/bean", "add");
注意，上述程序并不是处理 XML 文档，而且指明如何处理 XML 文档
然后，Digester 开始解析 XML 文档
digester.parse(is);
Digester 遍历整个 DOM 树， 当遇到一个元素时，便找到与该元素路径匹配的 Rule，并调用这个 Rule 来处理该元素。
Rule 使用 Digester 的 Object Stack 来使用或存放中间处理过程产生的对象。当整棵数遍历完毕时，Object Stack
栈底的对象即为最后结果对象。
2.3 使用 Digester 内建的规则
ObjectCreate
SetNext
SetProperties
SetProperty
CallMethod
FactoryCreate
2.4 使用自定义的规则
对于第一个例子，不使用内建的规则，而使用自定的规则处理，用于演示自定义规则的用法
public class ListRule
extends Rule
{
public void begin(String namespace, String name, Attributes attributes) throws Exception
{
/*将一个新的 ArrayList 对象放入 Object Stack 中*/
digester.push(new ArrayList());
}
}
public class BeanRule
extends Rule
{
public void begin(String namespace, String name, Attributes attributes) throws Exception
{
/*取出栈顶的对象，当处理该规则时，栈顶应该是 ArrayList*/
ArrayList list = (ArrayList) digester.peek();
Bean bean = new Bean();
bean.setId(attributes.getValue("id"));
bean.setDescription(attributes.getValue("description"));
list.add(bean);
}
}
Digester digester = new Digester();
digester.addRule("list", new ListRule()):
digester.addRule("list/bean" new BeanRule());
/*TODO: Load xml file as stream*/
InputStream is = null;
ArrayList list = (ArrayList) digester.parse(is);