1. digester 就是让你配置一个 xml 转到 java object 对应的程序, 当一些 xml
中特定的属性将会触发一些被称为 rules 的动作, 有一些属性是已经被定义好了,
当然你也可以建立自己所需要的. 而 digester 也包含了以下高级的特性 :

*能够嵌入你原本的对应方式, 而不会影响你的需求.
*自定义(customized)的 namespace-aware 的执行, 以至于你可以定义 rules 恰当独特的 xml
命名空间.
*将所有的 rules 放入 rulesets 可以简单方便地重复使用在其它需要相同类型的项目之中.


2. 使用 digester 之前, 你必须先拥有一些 libraries 在你的 classpath,
commons-digester, commons-beanutils, commons-collections, commons-logging,
及符合 sax ( simple api for xml ) 2.1 的 xml parser 或 jaxp ( java api for
xml parsing ) 1.2.1. 我是建议可以去抓 crimson 及 xerces 等等. 当前版本为：1.5
3. digester 的处理过程 (rule, xpath, object stack)
*建立一个新的对象 // 附注: 如果有两个一上相同属性名称, 因为堆叠会盖掉, 建议不采用
void addobjectcreate(java.lang.string pattern, java.lang.string classname, java.lang.string attributename)


*建立调用 method
void addcallmethod(java.lang.string pattern, java.lang.string methodname, int paramcount)


*建立调用 method 传入的参数
void addcallparam(java.lang.string pattern, int paramindex)


*xml 解析
java.lang.object parse(java.lang.string uri) throws java.io.ioexception, org.xml.sax.saxexception
使用 digester 内建的规则
objectcreate
setnext
setproperties
setproperty
callmethod
factorycreate
4. 使用自定义的规则
当你打开原码目录中, org/apache/commons/digester/　下有一个 digester-rules.dtd .
这个 dtd 文件就是在定义 digester 该如何解析你传入的 xml　文件, 你也可以自己定义相关的
patterns ,　写在 digester-rules.xml 中, 让 digester　可以根据你的需要去解析数据.
这样做可以减少程序中, 必须特别写 addobjectcreate, addcallmethod 等等 method.
不过, 我还没有见到目前有任何 project 采用这种做法.

<?xml version="1.0"?>
<!doctype digester-rules system "digester-rules.dtd">

<digester-rules>
<object-create-rule pattern="*/foo" classname="foo"/>
<set-properties-rule pattern="*/foo"/>
</digester-rules>

5. struts actionservlet 中用到的范例
protected void initservlet() throws servletexception {

//.......　省略　.................

// prepare a digester to scan the web application deployment descriptor
digester digester = new digester();
digester.push(this);
digester.setnamespaceaware(true);
digester.setvalidating(false);

//.......　省略　.................
// register our local copy of the dtds that we can find
for (int i = 0; i < registrations.length; i += 2) {
url url = this.getclass().getresource(registrations[i+1]);
if (url != null)
digester.register(registrations[i], url.tostring());
}

// configure the processing rules that we need
// 设置相关的元素和执行规则(rules)的对应
digester.addcallmethod("web-app/servlet-mapping","addservletmapping", 2);
digester.addcallparam("web-app/servlet-mapping/servlet-name", 0);
digester.addcallparam("web-app/servlet-mapping/url-pattern", 1);

inputstream input= null;
try {
// 获取 /web-inf/ 下的 web.xml　来作解析

input =
getservletcontext().getresourceasstream("/web-inf/web.xml");
digester.parse(input);

} catch (throwable e) {
log.error(internal.getmessage("configwebxml"), e);
} finally {
if (input != null) {
try {
input.close();
} catch (ioexception e) {
;
}
}
}

//.......　省略　.................

/**
* remember a servlet mapping from our web application deployment
* descriptor, if it is for this servlet.
*
* @param servletname the name of the servlet being mapped
* @param urlpattern the url pattern to which this servlet is mapped
*/
//当 digester　在 parse　时将执行 addservletmapping 这个 method
public void addservletmapping(string servletname, string urlpattern) {

if (log.isdebugenabled()) {
log.debug("process servletname=" + servletname +
", urlpattern=" + urlpattern);
}
if (servletname == null) {
return;
}
if (servletname.equals(this.servletname)) {
this.servletmapping = urlpattern;
}

}
}

相关书目或相关文章
*jakarta commons:
http://jakarta.apache.org/commons/index.html
*jakarta commons digester:
http://jakarta.apache.org/commons/digester.html
*simplify xml file processing with the jakarta commons digester :
http://jakarta.apache.org/commons/digester/api/index.html
如果你的英文还可以，可以看看这篇文章：
http://www.javaworld.com/javaworld/jw-10-2002/jw-1025-opensourceprofile.html