common digester-入门

Commons-Digester简介

一.历史

Digester原本仅仅是Jakarta Struts中的一个工具，用于处理struts-config.xml配置文件。显然，将XML文件转换成相应的Java对象是一项很通用的功能，这个工具理应具备更普遍的用途，因此很快它就在Jakarta Commons项目(用于提供可重用的Java组件库)中有了一席之地。

二.几个要点

简言之，Digester由"事件"驱动，经过调用预约义的规则操做对象栈，将XML文件转换为Java对象。工做原理以下:

Digester底层采用SAX解析XML文件，因此很天然的，对象转换由"事件"驱动，即在识别出特定XML元素时(实际被细分为begin、body、end、finish四个时点)，将执行特定的动做，好比建立特定的Java对象，或调用特定对象的方法等。此处的XML元素根据匹配模式(matching pattern)识别，而相关操做由规则(rule)定义。在转换过程当中，Digester维持了一个对象栈，能够看做对象转换的工做台，用来存放转换中生成的、或是为转换临时建立的Java对象。对输入XML文件做了一趟完整的扫描后，对象栈的栈顶元素即为目标对象。因为Digester屏蔽了SAX解析的细节，使用者仅需关注转换操做自己，大大简化了转换操做。

对使用者而言，Digester的核心在于匹配模式与规则(matching pattern + rule)。

匹配规则示例以下:
   <a>          -- Matches pattern "a"
     <b>        -- Matches pattern "a/b"
       <c/>     -- Matches pattern "a/b/c"
       <c/>     -- Matches pattern "a/b/c"
     </b>
     <b>        -- Matches pattern "a/b"
       <c/>     -- Matches pattern "a/b/c"
       <c/>     -- Matches pattern "a/b/c"
       <c/>     -- Matches pattern "a/b/c"
     </b>
   </a>

Digester提供了一些编程中常常用到的规则(rule)，如下五类九个rule较为经常使用:

A:对象建立
1.ObjectCreateRule   当begin()方法被调用时, 此rule建立相应Java对象, 并将其push到Digester的对象栈上。当end()方法被调用时, 栈顶对象将被pop, Digester内全部对该对象的引用都将失效。
2.FactoryCreateRule     建立Java对象的另外一种选择。当待建立的Java对象没有无参构造函数，或须要在建立时须要进行额外的设置时，须要用此rule。

B:属性设置
3.SetPropertiesRule     当begin()方法被调用时, Digester使用标准的Java反射API，将栈顶对象的属性设置为XML元素的同名属性值。
4.SetPropertyRule     当begin()方法被调用时, Digester调用栈顶对象某指定属性的设置方法，设置其值。

C:父子关系管理
5.SetNextRule     当end()方法被调用时, Digester将栈顶元素设置进次栈顶元素中(调用相应的设置方法)。
6.SetTopRule     当end()方法被调用时, Digester将次栈顶元素设置进栈顶元素中(调用相应的设置方法)。

D:任意方法调用
7.CallMethodRule     当end()方法被调用时, Digester将调用栈顶元素指定名称的方法。除了方法名外，此rule还须要配置参数数目，参数类型。参数值通常经过CallParamRule获得。
8.CallParamRule     此rule内嵌于CallParamRule中，按顺序(相对于0)定义了CallParamRule中参数值的来源，可选的来源包括当前XML元素的属性或内容。

E:其它
9.NodeCreateRule     将XML文件树的一部分转换为DOM节点，并push到Digester的对象栈上。

在基本使用中，使用者经过调用Digester类的相关方法，来建立匹配模式与规则的映射序列。好比，调用addSetProperties(String pattern)，向Digester中加入SetPropertiesRule。

三.如何使用？

基本步骤以下:
1.建立Digester对象实例。
2.设置该Digester对象的配置属性(可选)。
3.将须要的初始对象push到该Digester对象的对象栈上(可选)。
4.须要注册全部的XML元素匹配模式与处理规则之间的映射关系。
5.用digester.parse()解析的XML文档对象，获得目标对象。

下面是一个简单示例:
1.foo.xml   数据源文件
2.Foo.java   目标Java对象
3.Bar.java   目标Java对象
4.Entry.java   调用Digester的入口类

【foo.xml】
<?xml version="1.0" encoding="GBK"?>
<foo name="The Parent">
     <bar id="123" title="The First Child"/>
     <bar id="456" title="The Second Child"/>
</foo>

【Foo.java】
package org.easev.digester;

import java.util.HashMap;
import java.util.Iterator;

public class Foo {

     private String name;

     public void setName(String name) {
         this.name = name;
     }

     public String getName() {
         return name;
     }

     private HashMap bars = new HashMap();

     public void addBar(Bar bar) {
         bars.put(String.valueOf(bar.getId()), bar);
     }

     public Bar findBar(int id) {
         return (Bar) bars.get(String.valueOf(id));
     }

     public Iterator getBars() {
         return bars.keySet().iterator();
     }
}

【Bar.java】
package org.easev.digester;

public class Bar {

     private int id;

     public int getId() {
         return id;
     }

     public void setId(int id) {
         this.id = id;
     }

     private String title;

     public String getTitle() {
         return title;
     }

     public void setTitle(String title) {
         this.title = title;
     }
}

【Entry.java】
package org.easev.digester;

import java.io.File;
import java.util.Iterator;

import org.apache.commons.digester.Digester;

public class Entry {

     public static void main(String[] args) throws Exception {
         //相对路径定义与包名相关
         File input = new File("org/easev/digester/foo.xml");
         Digester digester = new Digester();
         digester.setValidating(false);

         //完整类名定义，包名改变时需作相应变化
         digester.addObjectCreate("foo", "org.easev.digester.Foo");
         digester.addSetProperties("foo");
         digester.addObjectCreate("foo/bar", "org.easev.digester.Bar");
         digester.addSetProperties("foo/bar");
         digester.addSetNext("foo/bar", "addBar", "org.easev.digester.Bar");

         Foo foo = (Foo) digester.parse(input);

         //测试装载是否成功
         Iterator iter = foo.getBars();
         while (iter.hasNext()) {
             System.out.println((String) iter.next());
         }
     }

}

匹配模式没有什么文章好作，那么下面要讨论的就必然是规则了。在基本的使用方式下，Digester虽然使用XML文件定义Java对象的状态，提升了系统的灵活性，可是匹配模式与规则的映射序列(装载逻辑)仍然经过硬编码来定义，这种方式不易修改与重用。因此Digester还提供了一种高级的使用方式，用一个XML文件定义Java对象的状态(数据源文件)，用另外一个XML文件定义装载数据源文件的装载逻辑。

这样，对象的装载过程分红了两步:
1.装载逻辑的"装载"，其结果表现为定义了rule的Digester；
2.根据上一步获得的Digester，装载目标对象。

套用上面的一个例子，增长了rule.xml，并改写了Entry.java

【rule.xml】
<?xml version='1.0'?>
<!DOCTYPE digester-rules 
   PUBLIC "-//Jakarta Apache //DTD digester-rules XML V1.0//EN" 
     "">

<digester-rules>
   <pattern value="foo">
     <object-create-rule classname="org.easev.digester.Foo"/>
     <set-properties-rule/>
     <pattern value="bar">
       <object-create-rule classname="org.easev.digester.Bar"/>
       <set-properties-rule/>
       <set-next-rule methodname="addBar"/>
     </pattern>
   </pattern>
</digester-rules>

【Entry.java】
package org.easev.digester;

import java.io.File;
import java.util.Iterator;

import org.apache.commons.digester.Digester;

public class Entry {

     public static void main(String[] args) throws Exception {
         //相对路径定义与包名相关
         File data = new File("org/easev/digester/foo.xml");
         File rule = new File("org/easev/digester/rule.xml");
         Digester digester = DigesterLoader.createDigester(rule.toURL());
         Foo foo = (Foo) digester.parse(data);
        
         //测试装载是否成功
         Iterator iter = foo.getBars();
         while (iter.hasNext()) {
             System.out.println((String) iter.next());
         }
     }

}

咱们能够看到，使用Digester的代码变得至关简洁，而要付出的代价就是为装载逻辑写一个配置文件。

四.其余的替代技术

除了Digester以外，固然还有其它的方法来实现Java对象的绑定与装载:1.java.util.Properties，简单的配置属性(好比数据库链接信息)，能够写在properties文件中，调用Properties对象的load(InputStream)方法将配置中的健值对加载到Properties对象中。这种方式通常仅适用于简单的配置信息的加载。2.JAXB，Java Architecture for XML Binding，在Java Web Services Developer Pack V 1.1中提供了一个参考实现。使用这种方式时，除了提供数据源XML文件以外，还必须提供相应的Schema文件。加载前，首先用Binding Compiler将Schema转换获得目标Java类的接口与实现，而后再调用Unmarshaller或Marshaller将数据源XML文件信息加载到Java对象中，或将设置的Java对象数据导出为XML文件。 3.XPath 4.JaxMe