将 Java 对象与 XML 数据集成
级别:中级
Brett McLaughlin(brett@oreilly.com)
作家兼编辑,O′Reilly and Associates
Quick 是一种开放源码数据绑定框架,着重于运行时转换。这篇介绍性文章向您演示了如何使用这种框架来快速且方便地将您的 Java 数据转换成 XML 文档,而无需其它数据绑定框架所需的类生成语义。本文还包括了大量的代码样本。
近几年来,XML 的确给编程世界带来了巨大冲击。然而,XML 应用程序的复杂性(从一开始就很复杂)在最近几年中并没有减少多少。开发人员仍要花几个星期的时间(即使不是几个月)来学习复杂的 XML 语义和 API(如 SAX 和 DOM)来操作 XML。然而,在过去的 6 个月到 12 个月中,相对于那些较复杂的 API,另一种新的比较简单的 XML API(称为 Quick)已经越来越受到欢迎。
数据绑定答应您直接在 Java 对象和 XML 之间映射,而不必处理 XML 属性和元素。另外,它答应 Java 开发人员使用 XML,而无需花时间去钻研 XML 规范。Quick 是这样一种数据绑定 API,它是使 Java 应用程序适合业务用途的项目。
安装与设置
在钻研使用 Quick 的细节之前,您需要下载和安装该项目。请访问 Quick 的网站(请参阅参考资料),然后选择 Download。然后,您可以下载该项目的 .zip 文件;在我写本文时,最新的可用版本是 Quick 4.3.1,可通过 Quick4.3.1.zip 文件得到。
解压缩 .zip 文件以创建 Quick 分发版(distribution)。清单 1 显示了目录层次结构:
清单 1. Quick 目录结构
Quick4
+-- JARs
+-- BATs
+-- Doc
+-- dtdParserSrc
+-- DTDs
+-- examples
+-- JARs
+-- QDMLs
+-- QJMLs
+-- quickSrc
+-- UTILs
+-- utilSrc
+-- XSLs
开发人员最关注的两个目录是 Quick4/BATs(它应该被添加到 PATH 环境变量)和 Quick4/JARs(它包含应该被添加到 CLASSPATH 环境变量的 jar 文件)。明确地讲,您需要将 dtdparser115.jar、Quick4rt.jar 和 Quick4util.jar 添加到当前类路径中。您还需要一个 SAX 解析器实现,如 Apache 项目的 Xerces-J(请参阅参考资料)。同样,将 xerces.jar 或您自己喜爱的解析器添加到类路径中。
Java 类和 XML 文档
数据绑定将集中于 XML 和 Java,所以让我们研究如何把这些 XML 文档和 Java 类与 Quick 联系起来。为了说明这些问题,让我们研究几个简单的 Java 类和一个简单的 XML 文档。
简单的 XML 文档
首先,清单 2 显示了一个小的 XML 文档。我已经使事情简单化,因此您读完 10 个或 15 个 Java 类之后,不会不理解概念。
清单 2. 表示一个人的 XML
<?xml version="1.0"?>
<!DOCTYPE person SYSTEM "person.dtd">
<person>
<firstName>Gary</firstName>
<lastName>Greathouse</lastName>
<address type="home">
<street>10012 Townhouse Drive</street>
<city>Waco</city>
<state>TX</state>
<zipCode>76713</zipCode>
</address>
<phoneNumber>
<type>home</type>
<number>2545550287</number>
</phoneNumber>
<phoneNumber>
<type>work</type>
<number>2545556127</number>
</phoneNumber>
</person>
虽然清单 2 不是有关如何编写 XML 的主要示例,但其中有几个关于 Quick 的要点值得注重。您还需要研究清单 3 中所示文档的 DTD。
清单 3. person.xml 的 DTD
<!ELEMENT person (firstName, lastName, address+, phoneNumber+)>
<!ELEMENT firstName (#PCDATA)>
<!ELEMENT lastName (#PCDATA)>
<!ELEMENT address (street, city, state, zipCode)>
<!ATTLIST address
type (home work other) "home"
>
<!ELEMENT street (#PCDATA)>
<!ELEMENT city (#PCDATA)>
<!ELEMENT state (#PCDATA)>
<!ELEMENT zipCode (#PCDATA)>
<!ELEMENT phoneNumber (type, number)>
<!ELEMENT type (#PCDATA)>
<!ELEMENT number (#PCDATA)>
Java 类
在许多数据绑定实现中,您现在需要生成 Java 源文件来表示这种类型的 XML 文档。