分享
 
 
 

用XmlBeans处理XML文档

王朝java/jsp·作者佚名  2006-01-03
窄屏简体版  字體: |||超大  

XML具有可读性,但这种代码编写时实在枯燥无味。对于那些懒惰且追求效率的程序员来说,编写这种沉闷乏味的代码最头疼。然而由于XmlBeans和E4X的出现,这些问题被迎韧而解。

现在的XmlBeans为2.0版本。XmlBeans由 BEA公司发明,后捐赠给Apache公司。当前世界都是XML/Java捆绑工具,而XmlBeans与众不同的是,它可用于很多与XML相关编程的领域,包括从低级节点,到非数据元素,到提取数据导向操作等方面。

使用XmlBeans可从一个XML Schema开始。下面我们将以一个简单程序作为范例,本文其它的例子可从这里下载。

我们的示范schema指定一个包括“sites”元素,这一“sites”元素又包含很多个“sites”元素,而这些元素又依次包含很多个“rating”或“comment”元素,每个元素都将一个邮件地址作为识别作者级别和注解的属性。

可以从Apache Web网站上获得XmlBeans并安装它。请记住将环境变量XMLBEANS_HOME设置为你安装的路径,并将$XMLBEANS_HOME/bin路径添加到安装目录。这可保证XmlBeans命令正确运行,即编译器“Scomp”能够正常工作。

如果我们现在运行:

scomp -out sites.jar sites.xsd

将可看到:

Time to build schema type system: 1.185 seconds Time to generate code: 0.131 seconds Time to compile code: 1.179 seconds Compiled types to: sites.ja

Scomp已经建立一个用于生成和编译Java代码的系统。在默认下,我们只能得到一个sites.jar文件作为输出。Scomp只能生成预编译的jar文件。如果你想看到生成的源代码,可运行:

scomp -srconly -src srcdir sites.xsd

现在我们可以看到,生成的Java classes 全部在com.example.sites.site程序包中,这些类来源于schema的目标名称空间。在Schema文件的开头行指定:

<?xml version="1.0" encoding="utf-8"?>

<?xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"

xmlns:si="http://www.example.com/sites/SITE"

targetNamespace="http://www.example.com/sites/SITE"

elementFormDefault="qualified">

如果你的schema没有一个目标名称空间,生成的类将出现在一个名为noNamespace的程序包中。比如一个名为SitesDocument的类,类的每一个属性都定义在schema,Sites,Site,Comment,Rating以及Email中。所有生成的类都会继承XmlBeans的基本类(即XmlObject)。现在我们可以直接剖析一个XML文档:

import com.example.sites.site.*;

import java.io.*;

import org.apache.xmlbeans.*;

public class Example1 {

public static void main(String[] args) {

try {

SitesDocument sd=SitesDocument.Factory.parse(new

File("./sites.xml"));

/* ......... */

}

catch (IOException e) {

System.err.println("IOException:"+e);

}

catch (XmlException e) {

System.err.println("XmlException:"+e);

}

}

}

在剖析过程出现错误将会产生一个XmlException。如果异常产生,我们已经做好相应处理。所有生成类都由一个静态Factory通过剖析或程序方式建立一些实例(instance)。这里我们使用的是简单的剖析方式。

我们添加一些代码以重复操作整个site并打印出注解和级别。首先必须得到文档的根元素(root element):

Sites sites=sd.getSites

XmlBeans以数组形式表示XML Schemas的顺序,我们可以获得这一数组并重复调用它(请记住我们使用的是Java SE 5.0):

for(Site s:sites.getSiteArray())

每一元素和属性都包含一些方法,你可以对它们赋值。现在我们提取site的src属性并打印它:

System.out.println(s.getSrc());

同样的道理,我们在Site元素中获得Rating和Comment数组,并重复调用:

for(Rating r:s.getRatingArray()) {

System.out.println(r.getEmail() + " rated the site "

+ r.getRated() + " on " + r.getRatedon());

}

for(Comment c:s.getCommentArray()) {

System.out.println(c.getEmail() + " said "

+ c.getStringValue());

}

}

接下来,我们就可以操作XML。我们添加一个site到文档:

Site newsite=sites.addNewSite();

同样,XMLbeans scomp已经生成了一些方法以允许你建立Site实例。现在我们必须做的就是设置“src”属性:

newsite.setSrc("http://www.example.net/specialpurpose.html");

通过索引方法也可以得到元素的顺序。例如,如果我们想在Site元素中插入一个Comment,可以使用:

Comment newcomment=newsite.insertNewComment(0);

即在0th位置上建立和插入一个空的Comment。现在我们需要设置它的属性和值:

newcomment.setEmail("fred@example.com");

newcomment.setStringValue("This was a reasonable addition");

之后,我们可以保存这一文档。

sd.save(new File("./newsites.xml"));

可以看到,本文讲到的例子代码可见到Example1.java。在运行这一程序之前,你必须将XmlBeans自带的xbean.jar和jsr173_api.jar,以及生成的sites.jar文件复制到lib目录。现在你可运行“ant example1”,将可在lib目录下得到一个newsites.xml文件。

查看newsites.xml文件,你可看到XmlBeans保存XML Infoset的演示过程。这一文件已经被修改,但你将会注意到sites.xml文件的comment没有被删除而保留在合适的位置。当你处理那些内容不能丢失的XML文件时,这一属性非常有用。

正如前面提到的,所有生成的类都是基于XmlObject,而XmlObject提供了浏览和验证更多的选项。在默认情况下,XmlBeans操作时没有验证。但通过调用XmlBean的vadilate()方法,你可以设置任何bean内容的验证,包括bean的子内容。验证内容包括XML Schema指定的各种限制。在我们的例子sites.xsd文件中,我们将对Emali类型进行限制,以确保输入合法的邮件地址。通过Email factory,我们可以建立Email的一个实例,对其设置数值,然后对其验证:

Email email=Email.Factory.newInstance();

email.setStringValue("email@example.com");

if(!email.validate()) { .... }

在例子中,Validate.java用于测试邮件地址的数组。对XmlBeans,以上方法并非唯一的验证机制。你可以设置一个验证错误“接收器”,即在某一位置上收集所有验证错误。或者,你可以在设置中打开验证。

为了浏览一个文档,可以使用任一XmlObject的XML Cursor。我们想查看例子文件中的第一个site元素:

String stnamespace="http://www.example.com/sites/SITE";

SitesDocument sd=SitesDocument.Factory.parse(new File("./sites.xml"));

Site site=sd.getSites().getSiteArray()[0];

XmlCursor cursor=site.newCursor();

此时,指针指向site元素。使用这一指针,我们可以查看整个文档内容。例如,我们想查看第一个element child:

cursor.toChild(stnamespace,"rating");

当你想以符号级别查看文档时,XmlCursors非常有用。以下例子(CoursorWalk.java)剖析一个文档,然后查看整个文档,并打印出查收结果:

XmlObject sd=XmlObject.Factory.parse(new File("./sites.xml"));

XmlCursor sdcursor=sd.newCursor();

while(sdcursor.hasNextToken()) {

sdcursor.toNextToken();

if(sdcursor.isText()) {

System.out.println(sdcursor.currentTokenType()

+ " " + sdcursor.getChars());

} else {

System.out.println(sdcursor.currentTokenType()

+ " " + sdcursor.getName());

}

}

值得一提的是,我们没有使用scomp生成的SiteDocument类,而直接使用XmlObject,这允许我们无需一个schema文件就可以剖析整个XML文件。

XmlBeans 的另一种查看文档方式为:定位于提取数据的相反端,使用XPath/XQuery 表达式可查询和选择文档。XmlObjects支持selectPath()和execQuery()方法,selectPath()用于选择文档中的节点,而execQuery()方法可允许XQuery 并建立一个完整的新XML以返回数据。

为了使用以上功能,你必须在classpath下添加更多的库,即8.1.1版本的Saxon库以及XmlBeans安装时附带的xbean_xpath.jar。你将会看到,Saxon版本中有一个与XmlBeans站点连接的链接,将saxon8.jar和xbean_xpath.jar文件复制到范例程序的lib目录下。

为了演示使用XPath查询的过程,这里给出SimpleXPath.java程序段。现在我们看看源代码:

String namespace="declare namespace st='http://www.example.com/sites/SITE';";

XmlObject[] sitelist=sd.selectPath(namespace+"//st:site[st:rating/@rated=5]");

for(Site site:(Site[])sitelist) System.out.println(site.getSrc());

开始,使用XQuery声明名称空间,然后调用selectPath()。selectPath() 和 execQuery()都返回了一组XmlObjects。实际的XPath为:

//st:site[st:rating/@rated=5]

即,选择任一rated属性为5的site元素,我们将可得到一组XmlObjects,由此得到一组Sites并打印出结果。

XPath 和 XQuery相互独立,但它们都能使XmlBeans执行查询和文档生成,其过程不需要减少schema类级别,而且不会让XmlBeans生成类的属性丢失。

XmlBeans功能很强大,其inst2xsd工具能够使用一系列XML文件并为你生成一个.xsd文件。

在下一文章中,我们将讲述有关E4X,并介绍结合E4X和XmlBeans访问基于信息服务的Web过程。

DJ Walker-Morgan是一名开发人员咨询师,专长是Java和用户对用户的消息发送和远程会议技术。

 
 
 
免责声明:本文为网络用户发布,其观点仅代表作者个人观点,与本站无关,本站仅提供信息存储服务。文中陈述内容未经本站证实,其真实性、完整性、及时性本站不作任何保证或承诺,请读者仅作参考,并请自行核实相关内容。
2023年上半年GDP全球前十五强
 百态   2023-10-24
美众议院议长启动对拜登的弹劾调查
 百态   2023-09-13
上海、济南、武汉等多地出现不明坠落物
 探索   2023-09-06
印度或要将国名改为“巴拉特”
 百态   2023-09-06
男子为女友送行,买票不登机被捕
 百态   2023-08-20
手机地震预警功能怎么开?
 干货   2023-08-06
女子4年卖2套房花700多万做美容:不但没变美脸,面部还出现变形
 百态   2023-08-04
住户一楼被水淹 还冲来8头猪
 百态   2023-07-31
女子体内爬出大量瓜子状活虫
 百态   2023-07-25
地球连续35年收到神秘规律性信号,网友:不要回答!
 探索   2023-07-21
全球镓价格本周大涨27%
 探索   2023-07-09
钱都流向了那些不缺钱的人,苦都留给了能吃苦的人
 探索   2023-07-02
倩女手游刀客魅者强控制(强混乱强眩晕强睡眠)和对应控制抗性的关系
 百态   2020-08-20
美国5月9日最新疫情:美国确诊人数突破131万
 百态   2020-05-09
荷兰政府宣布将集体辞职
 干货   2020-04-30
倩女幽魂手游师徒任务情义春秋猜成语答案逍遥观:鹏程万里
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案神机营:射石饮羽
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案昆仑山:拔刀相助
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案天工阁:鬼斧神工
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案丝路古道:单枪匹马
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案镇郊荒野:与虎谋皮
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案镇郊荒野:李代桃僵
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案镇郊荒野:指鹿为马
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案金陵:小鸟依人
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案金陵:千金买邻
 干货   2019-11-12
 
推荐阅读
 
 
 
>>返回首頁<<
 
靜靜地坐在廢墟上,四周的荒凉一望無際,忽然覺得,淒涼也很美
© 2005- 王朝網路 版權所有