利用SDO2.0创建和读取基于XML文档
引言:什么是 SDO?
Service Data Object (SDO) 2.0 是一个开放标准数据模型编程 API,允许开发人员在较高的级别方便地操作数据。尽管 SDO 1.0 以相同的数据抽象为目标,但有几个大的缺点,其中主要的一点是缺少 Helper 类,如 XSDHelper, XMLHelper 等。而最终结果是,开发人员被迫使用 SDO 1.0 实现 API(来自 Eclipse Modeling Framework (EMF) SDK)。
当前的实现 (SDO 2.0) 使用 EMF 2.2 SDK,但这个 SDO 2.0 实现细节并不会影响开发人员根据新 API 编写程序。将来,开放源代码社区(通过 Apache Software Foundation)可能会决定提供不同的 SDO 2.0 实现,但这不应影响基于 SDO 2.0 API 构建的应用程序。
了解这个新 API 的优势的最基本方法是使用 SDO 2.0 来创建符合 XML 模式 (XSD) 的 XML 文档并对其进行读取操作。要在不使用 SDO 2.0 的情况下完成相同的工作,开发人员需要理解 XML 解析器如何工作,并将数据解析逻辑与应用程序紧密集成。如果以后 XSD 需要更改,将需要对应用程序的各处进行调整,从而可能对代码的质量带来灾难性的影响。
SDO 2.0 API 的新用户很难直接通过学习规范来理解相关概念。为了提供一定的帮助,我们从 XML Schema Primer创建了一个示例,以说明如何使用 SDO 2.0 API 进行以下任务:
- 将 XML 文档写入到磁盘
- 从磁盘读取该文档。
场景:购买订单信息收集和配送
以下是我们将尝试通过我们的示例实现的使用场景。首先,公司确定购买订单(purchase order,PO)信息的要求。完成此任务后,我们就开始创建静态表单,以设计信息的结构。在数据库中,此静态表单即表模式。在 XML,此静态表单即 XML 模式 (XSD)。如果以后需要收集更多的客户信息,我们将需要重新设计表单/表模式/XSD。
下订单时,客户需要填写 PO 表单,或向操作员提供相同的信息,以便填写此表单。表单中的信息将随后由公司用于对订单进行配送。
公司接收到 PO 信息后,很有可能会将其进行保存,并在以后对其进行读取以用于各种目的(如提供客户支持)。在此示例中,我们可以将信息以 XML 格式保存,然后使用 SDO API 进行读取。
图 1 显示了从客户 Robert Smith 收集的 PO 信息示例。将创建 XSD 文件,以采用结构化的方式存储此示例购买订单。将用一个名为 CreatePurchaseOrder.java 的示例程序来采用 XML 格式创建示例 PO(名为 po.xml)。最后,将使用 ReadPurchaseOrder.java 来演示如何从 po.xml 读取订单信息。
图 1. 来自 Rober Smith 的示例购买订单信息
购买订单的 XML 模式
基于图 1 所示的示例购买订单,可以使用一个 PO 类型来表示订单。我们将其命名为 PurchaseOrderType。PurchaseOrderType 的实例可以包含四个主要数据,如下所示:
- shipping information
- billing information
- order items information
- comment
shipping information 和 billing information 可包含更多的数据,如 name、street、city、state、zip 和 country。Order items information 可以包含客户所购买的物品的很多信息。每个物品可能包含 part number、product name、quantity, price、ship date 和 comment。PO 的 comment 区域包含一个字符串值,并不要求采用更结构化的信息。
清单 1 显示了结构化为 XSD 格式的文件中包含的所有购买订单信息。
清单 1. PO.xsd