Jakarta Commons Digester是目前流行的、开放源码的XML文件处理实用软件包。本文简要介绍了Digester的功能,并且以一个程序来示范如何利用该软件简化原本复杂的XML配置文件的解析过程。
Apache小组的Jakarta项目下有许多知名的基于java的开放源码子项目,包括Tomcat,Ant,log4j,struts等等。相比之下,Jakarta Commons子项目在它们当中则属于知名度比较低的。该项目致力于提供可重用的java构件,例如:Commons BeanUtils, Commons DBCP 以及Commons Logging等。利用它们可以大大减少的一些乏味的重复编码工作。本文将重点介绍Commons Digester,它具有把XML文件映射到Java对象的能力。也许恰好她能解决你目前的问题呢!那么,请继续往下看吧。
需要注意的是:在启用Digester之前,你的classpath下必须已经安装了这些软件包:Digester ,BeanUtils, Collections, Logging,还有一个遵循SAX(Simple API for XML)2.0或JAXP(Java API for XML Parsing) 1.1规范的XML解析器。 有关Jakarta Commons所有的构件,以及两个合适的解析器Crimson和Xerces的链接可以在本文的相关资源中找到。
XML解析简介
总的来说,XML文件解析有2种基本方法。一种是DOM(Document Object Model)方法。采用DOM方法进行解析时,XML解析器读取整个XML文件并生成一个树状表达方式。另一个是使用SAX,它的特点是不需要遍历整个文件而是用事件驱动来解析文件。虽然DOM方法有时实现起来比较容易,但是与SAX方法相比速度更慢而且更耗资源。Digester构件通过为SAX事件提供高级的接口大大简化了SAX方法的解析过程。该接口隐含了大量XML文件处理的复杂的技术细节。使开发人员得以集中精力处理XML数据而不是花太多的时间在如何解析文件本身上。
Digester的几个重要概念
Digester引入了3个重要概念:元素匹配模式,处理规则以及对象栈。
元素匹配模式将处理规则与XML元素联系起来。以下是一个XML层次结构的元素匹配模式的例子。
- <datasources> 'datasources'
-
<datasource> 'datasources/datasource'
-
<name/> 'datasources/datasource/name'
-
<driver/> 'datasources/datasource/driver'
-
</datasource>
-
<datasource> 'datasources/datasource'
-
<name/> 'datasources/datasource/name'
-
<driver/> 'datasources/datasource/driver'
-
</datasource>
-
</datasources>
<datasources> 'datasources'
<datasource> 'datasources/datasource'
<name/> 'datasources/datasource/name'
<driver/> 'datasources/datasource/driver'
</datasource>
<datasource> 'datasources/datasource'
<name/> 'datasources/datasource/name'
<driver/> 'datasources/datasource/driver'
</datasource>
</datasources>
每当发现一个匹配的模式,对应的处理规则就被激活。在上面的示例中,与'datasource/datasource'相关联的规则将会运行2次。
处理规则定义了发现匹配的模式时产生的行为。Digester模块已经预定了不少处理规则,自定义的处理规则可以通过扩展 org.apache.commons.digester.Rule类来实现。
对象栈用来保存处理规则所要处理的对象。对象可以由人为或处理规则压入和弹出对象栈。
使用Digester
Digester 时常用于解析XML配置文件,下面例子中的XML文件包含了用于创建DataSource池的配置信息。 其中DataSource是抽象类,拥有一个空的构造函数,多个get,set方法来存取字符串。
- <?xml version="1.0"?>
-
<datasources>
-
<datasource>
-
<name>HsqlDataSource</name>
-
<driver>org.hsqldb.jdbcDriver</driver>
-
<url>jdbc:hsqldb:hsql://localhost</url>
-
<username>sa</username>
-
<password></password>
-
</datasource>
-
<datasource>
-
<name>OracleDataSource</name>
-
<driver>oracle.jdbc.driver.OracleDriver</driver>
-
<url>jdbc:oracle:thin:@localhost:1521:orcl</url>
-
<username>scott</username>
-
<password>tiger</password>
-
</datasource>
-
</datasources>
<?xml version="1.0"?>
<datasources>
<datasource>
<name>HsqlDataSource</name>
<driver>org.hsqldb.jdbcDriver</driver>
<url>jdbc:hsqldb:hsql://localhost</url>
<username>sa</username>
<password></password>
</datasource>
<datasource>
<name>OracleDataSource</name>
<driver>oracle.jdbc.driver.OracleDriver</driver>
<url>jdbc:oracle:thin:@localhost:1521:orcl</url>
<username>scott</username>
<password>tiger</password>
</datasource>
</datasources>
. 要使用Digester对之进行解析,首先我们要创建一个Digester类的实例,然后把所需的对象都压入到Digester对象栈中,设置一系列处理规则,最后,对文件进行解析。下面是一个例子:
- Digester digester = new Digester();
-
digester.addObjectCreate("datasources/datasource", "DataSource");
-
digester.addCallMethod("datasources/datasource/name","setName",0);
-
digester.addCallMethod("datasources/datasource/driver","setDriver", 0);
-
digester.parse("datasource.xml");
Digester digester = new Digester();
digester.addObjectCreate("datasources/datasource", "DataSource");
digester.addCallMethod("datasources/datasource/name","setName",0);
digester.addCallMethod("datasources/datasource/driver","setDriver", 0);
digester.parse("datasource.xml");
在这个例子中,你可以看到,addObjectCreate()方法把一个 ObjectCreateRule添加到'datasources/datasource'模式中。这样,ObjectCreateRule将创建一个新的DataSource类的实例并把它压入Digester的对象栈中。随后,addCallMethod()方法把CallMethodRule分别添加到两个模式中。结果是,CallMethodRule将调用位于对象栈顶部的对象的特定的方法,addCallMethod()的最后一个参数指定了传入该方法的参数数目,如果数目为0则匹配上的数据项内容将作为参数传入。(注:类ObjectCreateRule,CallMethodRule 都是Digester模块已定义的处理规则)
假如应用这个代码断来处理在前面提到的XML文件,将会发生以下结果:
· 一个新的DataSource类的实例将被创建并压入堆栈;
· 调用该实例的setName(String name)方法,参数值为'HsqlDataSource';
· 调用该实例的setDriver(String driver)方法,参数值为'OracleDataSource'。
在对'datasource'元素的处理结束后,对象从堆栈中弹出,文件剩余部分的解析重复以上过程。上面的例子存在一个问题,在对相关元素的处理结束后,ObjectCreateRule会弹出它创建的对象。因此,当Digester 完成解析文件后,只有最后一次创建的对象被保留下来。解决这个问题也很容易,只要把对象在解析开始之前压入堆栈,随后调用该对象的某个方法来创建所需的任意对象。下面的类就是这个办法的一个演示:
- public class SampleDigester
- {
-
public void run() throws IOException, SAXException
- {
-
Digester digester = new Digester();
-
-
-
-
digester.push(this);
-
-
-
-
digester.addCallMethod ("datasources/datasource", "addDataSource", 5);
-
digester.addCallParam("datasources/datasource/name", 0);
-
digester.addCallParam("datasources/datasource/driver", 1);
-
digester.addCallParam("datasources/datasource/url", 2);
-
digester.addCallParam("datasources/datasource/username", 3);
-
digester.addCallParam("datasources/datasource/password", 4);
-
-
digester.parse("datasource.xml");
- }
-
-
public void addDataSource(String name,
- String driver,
- String url,
- String userName,
- String password)
- {
-
- }
- }
public class SampleDigester
{
public void run() throws IOException, SAXException
{
Digester digester = new Digester();
// This method pushes this (SampleDigester) class to the Digesters
// object stack making its method s available to processing rules.
digester.push(this);
// This set of rules calls the addDataSource method and passes
// in five parameters to the method.
digester.addCallMethod ("datasources/datasource", "addDataSource", 5);
digester.addCallParam("datasources/datasource/name", 0);
digester.addCallParam("datasources/datasource/driver", 1);
digester.addCallParam("datasources/datasource/url", 2);
digester.addCallParam("datasources/datasource/username", 3);
digester.addCallParam("datasources/datasource/password", 4);
// This method starts the parsing of the document.
digester.parse("datasource.xml");
}
// Example method called by Digester.
public void addDataSource(String name,
String driver,
String url,
String userName,
String password)
{
// create DataSource and add to collection...
}
}
在上面的SampleDigester类中,每当匹配到 'datasources/datasource'时都会自动调用addDataSource()方法。addCallParam()方法将匹配到的数据项内容作为传入addDataSource()方法的参数。在addDataSource()方法中,你就可以创建具体的DataSouce并把它添加入你的DataSource集合中去。
深入了解Digester
尽管Digester最初是为了简化对XML配置文件的解析而开发的。但是它也可以用在把 XML文件映射到java对象的场合。本文只是对Digester的简要介绍。如果要深入了解Digester或Jakarta Commons 项目中的其他公共组件,可以访问Jakarta Commons的官方网站。另外,可以参考以下的相关资源,从这些开放源代码的项目应用中学习Digester的用法。
相关资源
·The Jakarta Commons homepage: http://jakarta.apache.org/commons
·Two open source XML parsers suitable for use with Digester are:
o Xerces
o Crimson
·Open source projects that use Digester:
o Struts
o Tomcat
·Other Jakarta Commons components:
http://jakarta.apache.org/commons/components.html
· Erik Swenson's previous Open Source Profile column, "Reports Made Easy with JasperReports" (JavaWorld, September 2002):
http://www.javaworld.com/javaworld/jw-09-2002/jw-0920-opensourceprofile.html
· Browse the Java and XML section of JavaWorld's Topical Index:
http://www.javaworld.com/channel_content/jw-xml-index.shtml
·Chat about Java development in the JavaWorld Forum:
http://forums.devworld.com/webx?13@@.ee6b802
· Sign up for JavaWorld's free weekly email newsletters:
http://www.javaworld.com/subscribe
· You'll find a wealth of IT-related articles from our sister publications at IDG.net
相关推荐
digester组件简化了xml文件处理操作
Digester的XML规则文件配置: 在Digester中提供了一个包:org.apache.commons.digester.xmlrules。这个包中的类可以从一个XML文档中读取并返回一个指定的配置信息...XML文档配置文件必须使用DTD,这是xmlrules包的一部分
Digester解析XML文件
digester解析xml的问题.pdf
Digester解析XML,也是找到的别人的。
使用Digester解析XML文档示例
这是一个JAVA工程,导入后可直接运行,主要演示如何用digester解析XML文件
使用digester配置rule.xml规则来解析自定义的xml文件
Digester读取XML学习,Digester读取XML学习
Digester读取xml教程.rar
不错的解析XML的类,主要利用org.apache.commons.digester.Digester;
博文链接:https://aga.iteye.com/blog/218587
Digester解析XML问题.pdf
利用Digester把XML转换成为Java对象
使用STRUTS的解析XML技术digester来解析多层嵌套的XML文件,简单易懂
java反射,Digester解析xml文档
使用Apache的Digester来解析XML文档,代码,有解析!
Digester java解析xml jar包
digeter解析xml所必须的jar包,包括commons-logging-1.2.jar、commons-digester-2.1.jar、commons-beanutils-1.9.3.jar
org.apache.commons.digester解析XML.rar 完整的测试工程,里面有需要的四个包