Chinaunix首页 | 论坛 | 博客
  • 博客访问: 1894408
  • 博文数量: 606
  • 博客积分: 9991
  • 博客等级: 中将
  • 技术积分: 5725
  • 用 户 组: 普通用户
  • 注册时间: 2008-07-17 19:07
文章分类

全部博文(606)

文章存档

2011年(10)

2010年(67)

2009年(155)

2008年(386)

分类:

2008-07-28 20:41:08

在一个比较完整的应用系统里,经常需要有一些配置文件。简单的属性使用.properties文件即可,但要配置一些复杂对象,则应该考虑使用xml文件。一般用来读取xml文件的工具包有DOM、SAX和JDOM等,但用过的人都知道,它们属于比较底层的API,写起来代码量很大,而且如果修改了xml文件的格式,代码也要做大幅度的改动。Jakarta Commons项目里的包,可以轻松实现xml文件到Java对象的转换,看下面这个例子。

在一个项目里,需要提供一些统计图,但图的内容暂时未能确定。所以我决定让图可以配置,所有定义保存在一个名为charts.xml(或国际化后的文件名如charts_zh_CN.xml,这里只考虑缺省语言)的文件内,下面是该文件的部分内容:

xml version="1.0" encoding="UTF-8" ?>
<charts>
    
<chart id="BarChart1" >
        
<title>统计图一title>
        
<legendVisible>falselegendVisible>
        
<toolTipsVisible>truetoolTipsVisible>
        
<type>Bartype>
        
<labelx>时间labelx>
        
<labely>数据labely>
        
<width>500width>
        
<height>360height>
        
<hql>select count(c),c.department.name from edu.pku.pub.aims.model.business.Client c group by c.departmenthql>
        
<description>description>
    
chart>
charts>

可以看出,我为每个图定义了id、title、legendVisible等等属性,这些属性的意义都很明显,它们将影响统计图的数据和在页面中的表现。在程序里,我需要把这个文件里的定义读到一个注册表类ChartRegistry里,该注册表维护一个java.util.List类型的registry变量,其中每个元素是一个ChartConfig类。现在Digester该显示它的价值了。

为了方便使用Digester,我们让ChartConfig也具有统计图的每个属性(id、title、legendVisible等等),名称与charts.xml里的元素的属性(子元素)一一对应,并且都具有getter和setter方法,也就是说,ChartConfig是一个bean类。在ChartRegistry类里定义一个deregister()方法,它的作用是用Digester读入并解析指定的xml文件,代码如下;还有一个register()方法用来把ChartConfig对象加到registry里。

package chengang.digester;

import java.io.FileInputStream;
import java.io.IOException;
import java.io.InputStream;
import java.net.MalformedURLException;
import java.net.URL;
import java.util.ArrayList;
import java.util.Collections;

import org.apache.commons.digester.Digester;
import org.xml.sax.SAXException;



/**
*
* @author ChenGang
*/
public class ChartRegistry {

public static void main(String[] args) throws MalformedURLException, IOException, SAXException {
new ChartRegistry().deregister(new URL("file:\\E:\\eclipse\\workspace\\wxxr_boss_connector\\charts.xml"));
}

java.util.List registry=new ArrayList();

public void deregister(URL url) throws IOException,SAXException{
InputStream is = new FileInputStream(url.getFile());
Digester digester = new Digester();
digester.push(this);
digester.setValidating(false);
digester.addObjectCreate("charts/chart", ChartConfig.class);
digester.addSetProperties("charts/chart");
digester.addBeanPropertySetter("charts/chart/legendVisible");
digester.addBeanPropertySetter("charts/chart/type");
digester.addBeanPropertySetter("charts/chart/width");
digester.addBeanPropertySetter("charts/chart/description");
digester.addSetNext("charts/chart","register");
digester.parse(is);
Collections.sort(registry);
}

public void register(ChartConfig obj){
registry.add(obj);
}
}


package chengang.digester;

/**
*
* @author ChenGang
*/
public class ChartConfig {
private String id;

private boolean legendVisible;

private String type;

private int width;

private String description;

public String getDescription() {
return description;
}

public void setDescription(String description) {
this.description = description;
}

public String getId() {
return id;
}

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

public boolean isLegendVisible() {
return legendVisible;
}

public void setLegendVisible(boolean legendVisible) {
this.legendVisible = legendVisible;
}

public String getType() {
return type;
}

public void setType(String type) {
this.type = type;
}

public int getWidth() {
return width;
}

public void setWidth(int width) {
this.width = width;
}
}

基本上来说,Digester和SAX解析xml的过程很像,它的原理就是制定一些规则,在遍历每个节点时检查是否有匹配的规则,如果有就执行对应的操作。例如,上面的代码中,“digester.addObjectCreate("charts/chart", ChartConfig.class);”这一句的作用是告诉Digester:如果遇到匹配“charts/chart”形式的节点,就执行一个“对象创建”操作,创建什么对象呢,应该创建Class为“ChartConfig.class”的对象;类似的,addSetProperties()是告诉Digester将指定节点的属性全部映射到对象的属性,在这个例子里指的就是id属性;addBeanPropertySetter()是将子节点转换为对象的属性,这个方法还可以有第二个参数,当对象的属性名和子节点的名字不一样时用来指定对象的属性名;addSetNext()是说在遇到匹配节点后,对当前对象的父对象执行一个方法,参数是当前参数,对这个例子来说就是执行ChartConfig.register(ChartConfig)方法。因此这样构造得到的Digester会把charts.xml里的每个元素转换为一个ChartConfig对象,并register到ChartRegistry里。

顺利得到了ChartRegister对象,我就可以在程序里根据它的内容构造统计图了(统计图一般使用jfreechart来生成,这里就不赘述了)。与Digester具有类似功能的工具包其实还有不少,例如Caster、Jato等等,我没有实际使用过它们,但因为我对用过的Jakarta其他项目都很满意(例如BeanUtils、HttpClient,品牌效应?),所以一开始就选择了Digester:简单方便。要使用digester, 要下载以下文件:
commons-digester.jar
commons-collections.jar
commons-logging.jar
commons-beanutils.jar

还有一个sax的包。 但是,JDK里捆绑了,所以不用再麻烦去下载了。

阅读(788) | 评论(0) | 转发(0) |
给主人留下些什么吧!~~