从 XML 到 Java 代码的数据绑定（2）:从 XML 数据创建类(转)

　　数据绑定系列的第二篇是如何从 XML 数据限制中生成一个 Java 语言。 本文通过完整的代码展现了如何生成类和代码，并提供了如何定制您自己版本的建议。 还没有看过第一篇吗？第一篇， "对象,无处不在的对象"， 解释了数据绑定是如何将 XML 和 Java 语言对象互为转换。它比较了数据绑定和其它在 Java 程序中处理 XML 的方法， 并介绍了一个 XML 配置文档示例。第一部分也介绍了使用 XML Schema 来约束数据。

　　在深入 Java 程序和 XML 代码之前，先快速回顾一下本系列第一部分所打下的基础。

　　在第一部分中，我们知道只要可以标识文档的一组约束，就可以将文档转换成 Java 对象。那些约束为数据提供了接口。如 WEB 服务配置文档示例中所示，XML 文档应当成为现有 Java 类的一个实例，并且从数据约束生成那个类。最后，会看到表示样本 XML 文档约束的 XML schema。

　　如果对细节还有疑问，请回顾 第一篇文章.

　　打造基础

　　现在，可以着手从 XML schema 创建 Java 类。该类必须准确表示数据约束，并提供 Java 应用程序将使用的简单读方法和写方法。开始之前，让我们先回顾清单 1，查看为 WebServiceConfiguration 文档定义的 XML schema。

　　清单 1. 表示 Web 容器配置文档数据接口的 XML schema

　　生成代码

　　开始生成 Java 代码之前，首先必须确定核心类的名称。将使用 org.enhydra.xml.binding 包中的 SchemaMapper，它是 Enhydra 应用服务器实用程序类集合的一部分。还可以将任何必需的支持类放到这个包中。

　　除了类名称以外，还必须确定用来读取和创建 XML 的 Java api。如上一篇文章中所讨论过的，三种主要选择是 SAX、DOM 和 JDOM。由于 SAX 仅仅适用于读取 XML 文档，因此它不适合创建 XML。由于在打包阶段中要将 Java 对象转换为 XML 表示，因此在此阶段中需要创建 XML。这就将选择的范围缩小到 DOM 和 JDOM。在这两种选择都可用的情况下，本例中我选择使用 JDOM API，仅为了显示其功能性（并不仅仅因为我是它的合著者之一！）。

　　最后，必须指出如何将 XML schema 提供给 SchemaMapper 类。通常，可以假设类的生成是脱机完成的（通过静态 main 方法）。仅通过使 main 方法调用非静态方法，还可以从运行时环境中使用类。做了这些决定后，就可以开始勾画类的框架了。

　　组装 SchemaMapper 类框架

　　要做的第一件事就是为要生成的代码设置一些基本存储器。必须能够从每个执行映射的 XML schema 生成多个接口和实现。Java HashMap 正好满足要求。键是接口或实现名称以及映射表中的值，该值是将要输出到新 Java 程序文件的实际代码。还需要存储每对接口／实现的属性（属性是在这两种类之间共享的）。这里，我再次使用 HashMap。其中，键是接口名称。但是，由于每个接口可能有多个属性，因此该值是另一个具有属性及其类型的 HashMap。最后，必须存储 XML schema 的名称空间，因为 JDOM 将使用这个名称空间来访问 XML schema 中的结构。所有这些具体信息都足以初步勾画出新类的框架，新类在清单 2 中。

　　还请注意在清单 2 中已添加了两个需要使用的基本方法：其中一个方法需要使用 XML schema 的 URL 来执行生成（允许它在网络可访问 schema 以及本地 schema 下运行），另一个方法将类输出到指定的目录中。最后，简单的 main 方法将 XML schema 看作一个变量，然后执行生成。

　　清单 2. SchemaMapper 类的框架

　　package org.enhydra.xml.binding;import java.io.File;import java.io.FileNotFoundException;import java.io.FileWriter;import java.io.IOException;import java.net.URL;import java.util.HashMap;import java.util.Map;import java.util.Iterator;import java.util.List;　　　　// JDOM classes used for document representationimport org.jdom.Document;import org.jdom.Element;import org.jdom.JDOMException;import org.jdom.Namespace;import org.jdom.NoSuchAttributeException;import org.jdom.NoSuchChildException;import org.jdom.input.SAXBuilder;　　　　private Map interfaces;private Map implementations;protected Map properties;private Namespace schemaNamespace;private static final String SCHEMA_NAMESPACE_URI ="Http://www.w3.org/1999/xmlSchema";　　　　public SchemaMapper() {interfaces = new HashMap();implementations = new HashMap();properties = new HashMap();schemaNamespace = Namespace.getNamespace(SCHEMA_NAMESPACE_URI);}　　　　public void generateClasses(URL schemaURL) throws IOException {　　　　// PerfORM generation}　　　　public void writeClasses(File dir) throws IOException {　　　　// Perform output to files}　　　　public static void main(String[] args) {SchemaMapper mapper = new SchemaMapper();try {for (int i=0; i

　　In 清单 2中，可以看到对于每个作为自变量传递的 XML schema，main 方法都调用生成过程。首先，方法会生成类。将文件名转换为 URL，并传递到 generateClasses(URL schemaURL) 。然后，通过 writeClasses(File dir) 方法将类写到当前目录中（转换成 Java File: new File(".")）。

　　任何其它 Java 类都可以在运行时进行相同的调用，并生成类。例如，一个定制类装入器也许能发现需要打包，确定仍要生成的接口和实现，并使用 SchemaMapper 类来执行该任务。所有这一切都在运行时完成。因为 generateClasses() 方法需要一个 URL，所以在网络上使用这个类非常简单。例如，可以使用它来请求从 HTTP 上公开可用的 XML schema 生成类。

　　由于对如何使用类做了尽量少的假设，因此它是一个普通类；程序可以同时在本地和远程使用它。并且这个类可以当作一组 Java 语言和 XML 实用程序类的一部分，而不是必须以某种特殊形式使用的专用类。这种可重用性原则对 XML 特别关键，因为在不同系统上进行网络访问和通信是 XML 的基本前提。

　　生成类

　　构建好类的框架后，就可以添加类的主体了。

　　我已经提到过生成过程具有递归性质。请记住这一点，需要填充 generateClasses() 方法才能开始。可以使用 JDOM 读取 XML schema，然后从 schema 中抽取每个 complexType 元素。对于这些元素中的每一个，如清单 3 所示，递归进程从 handleComplexType() 调用处开始（以后将进一步讨论）。

　　清单 3. The generateClasses() 方法

　　public void generateClasses(URL schemaURL) throws IOException {　　　　　 SAXBuilder builder = new SAXBuilder();try {Document schemaDoc = builder.build(schemaURL);　　　　　// Handle complex typesList complexTypes = schemaDoc.getRootElement().getChildren("complexType",schemaNamespace);for (Iterator i = complexTypes.iterator(); i.hasNext(); ) {　　　　　// Iterate and handleElement complexType = (Element)i.next();handleComplexType(complexType);}} catch (JDOMException e) {throw new IOException(e.getMessage());}}　　　　

　　为简便起见，将强调一些重点，而不是详细阐述将 schema 转换为 Java 类的整个过程。可以 联机查看完整的 SchemaMapper 类，或者可以 下载它。

　　生成器必须确定在 XML schema 中找到的每个 complexType 元素是 显式的（具有“类型”属性），还是 隐式的（没有“类型”属性）。如果类型是显式的，则类型将成为接口名称，并且首字母大写。如果类型是隐式的，那么将根据特性名称构造接口名称。清单 4 中显示了处理这个逻辑的代码段。（如要了解更多数据绑定的定义，请参阅侧栏， 术语解释。）

　　清单 4. 确定接口名称

　　　　　　　　　　　　　　// Determine if this is an explict or implicit typeString type = null;　　　　// Handle extension, if neededString baseType = null;try {　　　　// Assume that we are dealing with an explicit typetype = complexType.getAttribute("name").getValue();} catch (NoSuchAttributeException e) {　　　　 try {type = new StringBuffer().append(BindingUtils.initialCaps(complexType.getParent().getAttribute("name").getValue())).append("Type").toString();} catch (NoSuchAttributeException nsae) {　　　　// Shouldn't happen in schema-valid documentsthrow new IOException("All elements must at have a name.");}}　　　

　　因此，根据代码中的命名约定， 具有ServiceConfiguration 类型的元素将生成名为 ServiceConfiguration 的 Java 接口。名为 port 但 没有显式类型的元素将生成叫做 PortType 的 Java 接口。它采用元素名称 ( port )，将首字母转成大写 ( Port )，再加上单词 Type ，就得到了 PortType 。

　　同样，所有实现类都使用接口名称，然后添加缩写 Impl 。所以，最终实现类是 ServiceConfigurationImpl 和 PortTypeImpl 。

　　使用这些命名约定，您可以很容易地确定将数据约束映射到 Java 接口会得到哪些 Java 类。如果设置了应用程序在运行时装入类，那么类装入器或其它实用程序可以迅速确定是否已装入了所需的类。类装入器或实用程序只要从 XML schema 中找出生成的类名称，然后尝试装入它们就可以了。命名逻辑是事先确定的，因此检查起来非常方便。

　　一旦确定了名称，就可以生成接口和实现类的框架（请参阅清单 5）。

　　清单 5. 生成代码

　　StringBuffer interfaceCode = new StringBuffer();StringBuffer implementationCode = new StringBuffer();　　　　interfaceCode.append("public interface ").append(interfaceName);　　　　// Add in extension if appropriateif (baseType != null) {interfaceCode.append(" extends ").append(baseType);}interfaceCode.append(" {