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"?>


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");
/*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);