体验 Spring 的 Object/XML 映射支持

Spring 是由 Rod Johnson 开发的一个健壮的 Java 应用程序框架，已在 Java 开发社区中得到广泛使用。Spring 以其流行的科技词汇而著名，比如 “dependency injection（依赖项注入）”、“inversion of control（控制反转）” 和 “aspect-oriented programming（面向方面编程）” 等。它还支持 Model-View-Controller (MVC) 模式，很好地兼容用于数据访问的各种数据库驱动程序。另外，它支持事务处理、单元测试、批处理和安全性。

鉴于 Spring 的良好声誉和悠久历史，它通常是应用程序快速开发的首选框架。但是，最大的好处也许是：Spring 是免费的。

?

如您所见，这个配置文件只定义了两个 bean，这是为了简便起见。第一个 bean 是用于执行演示的类：com.xyz.OXMExample。与该类关联的两个属性使用依赖项注入，它们都使用 castorMarshaller bean 的一个实例注入。这是在 Spring 框架中定义 bean 的标准方法，经验丰富的 Spring 开发人员很快就会意识到这一点。

另一个 bean 是 castorMarshaller bean 本身，它是 org.springframework.oxm.castor.CastorMarshaller 的一个实例，org.springframework.oxm.castor.CastorMarshaller 主要用于包装 Castor 框架。如前所述，使用 Spring 的 O/X 功能需要使用一个第三方 O/X 框架。在本例中，这个第三方产品是 Castor。还要注意，有一个属性使用 castorMarshaller 定义，那是用于在 Java bean 和 XML 输出之间来回映射的映射文件。这个文件称为 mapping.xml，它必须 在运行时位于类路径中。我将稍后解释 mapping.xml 文件的内容。

清单 2 实际执行 O/X 映射器的代码的部分清单。如您所见，它是一个简单的 Java 类。

清单 2. OXMExample 类（节选）

?

要解释 清单 2，必须首先介绍 main 方法，因为该方法将先执行。然后再接着介绍清单 2。

首先，在 main 方法中，您的代码捕获 Spring 应用程序的上下文，就是您在 清单 1 中看到的配置文件。这个文件必须在类路径中，否则运行代码将产生一个异常。

当您获得应用程序上下文时，OXMExample 的一个实例从该配置文件中提供的定义创建。注意，这个 bean 在代码中的名称（oxmExample）与配置文件中定义的名称（见清单 1）一致。创建 OXMExample 的一个实例后，调用 go() 方法。这有点反常，因为 Spring 框架实例化一个已经从命令行运行的对象，但那只是为了实现演示目的而进行的简化。

go() 方法在打印结果数据前完成 3 个任务：

创建 SimpleBean 的一个实例。 编组该实例。 解组从编组创建的 XML 文档。

您使用 getSimpleBean() 方法实例化一个包含一个虚拟员工的信息的 SimpleBean 对象。这个信息包含年龄（一个整数）、工作描述（一个字符串）、姓名（一个字符串）和该员工是否是执行官（一个布尔型）。您使用测试数据和返回调用者的返回对象（在本例中为 go() 方法）填充字段。您在编组发生时将这个 bean 写入一个 XML 文件，在解组发生时读取那个 XML 文件的内容。

saveSimpleBean() 方法执行编组。首先，您获得一个指向 simplebean.xml 的对象，然后，您使用编组器对象（通过 Spring 的依赖项注入实例化）调用 marshal 方法。这个方法需要两个参数：

要被编组的对象（本例中为 SimpleBean 实例） 一个 StreamResult 对象，它基本上表示一个 XML 输出抽象

loadSimpleBean() 方法执行解组。首先，您获取一个指向 simplebean.xml 的 FileInputStream 对象，然后，您使用解组器对象（通过 Spring 的依赖项注入实例化）调用 unmarshal 方法。唯一需要的参数是一个包装 FileInputStream 对象的 StreamSource 对象。注意，解组将创建一个泛型对象，因此您必须将其显式设置为 SimpleBean 类型。

即使这个类和 Spring 配置文件已经就绪，您也还没有准备好运行这段代码。还记得 清单 1 中的映射文件吗？您还需要定义那个映射文件。定义代码如 清单 3 所示，而且，再说一遍，它也必须在运行时位于类路径中。

清单 3. mapping.xml 文件

?

清单 3 中的映射文件特定于 O/X 映射的 Castor 实现。第一个元素（class）定义要映射到一个 XML 输出的类。您必须指定完整路径。

map-to 元素提供 XML 文件的根元素的名称。这很重要，因为 XML 规范规定，每个 XML 文件必须有一个根元素。

每个 field 元素都将被映射到 SimpleBean 类中的一个特定字段。每个 field 元素的 bind-xml 子元素用于指定关于该字段的特定于 XML 的信息，如对应的 XML 元素的名称，每个字段的值应该是一个元素值还是一个属性值。如您所见，在本例中，所有值都是元素值。

?

清单 4 显示了来自应用程序的编组端的输出，而 清单 5 则显示来自应用程序的解组端的结果，这些结果将在您的控制台中显示。

清单 5. 解组输出

name: Mister Jonesjob description: Janitorage: 35executive: false

?

现在，您已经成功地完成了您的首次 Spring O/X 映射测试。祝贺您！

现在最好做开发人员应该做的工作：修改代码。向类添加字段并将它们映射到 XML 文件。删除一些字段并将它们从 XML 文件中移除。参考 Castor 文档，尝试一些更复杂的工作，比如嵌套元素。您可以随心所欲地尝试各种可能性。

结束语

Spring 的 O/X 映射接口是 Spring 框架的强大特性。借助它，您不仅可以将 XML 文档转换为 Java 对象，还可以将 Java 对象转换为 XML 文档。

它利用 Spring 的一个关键优势：依赖项注入。通过结合使用依赖项注入和 Spring 的 O/X Mapper，您可以轻松开发一个解决方案，该方案可以使用任一 O/X 实现，比如 Castor、XBeans、JiBX、JAXB 和 XStream。由于各个特定实现是 Spring 强大的 Inversion of Control 容器的一部分，开发人员可以在多个特定 O/X 实现之间轻松切换而无需修改代码。

Spring 的 O/X Mapper 还向开发人员提供一个统一的异常层次结构，这意味着不管您使用哪个第三方实现，抛出的运行时异常都是相同的。再强调一次，这将有利于在多个 O/X 供应商之间切换。

在 Java 开发社区中，提供 XML 支持的 Java 应用程序非常热门并且 Spring 框架被广泛使用，因此 Spring 的 O/X Mapper 将受到全世界 Java 应用程序开发人员的欢迎。

<!-- CMA ID: 453658 --><!-- Site ID: 10 --><!-- XSLT stylesheet used to transform this file: dw-article-6.0-beta.xsl -->

?