*Allocate storage and set up defaults.*

*This is the "entry point" for generation of Java classes from an XML*Schema. It allows a schema to be supplied, via URL,*and that schema is used for input to generation.*

*This will write out the generated classes to the supplied stream.*

*This provides a static entry point for class generation from*XML Schemas.*

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 {　　　　　 /*** Create builder to generate JDOM representation of XML Schema,* without validation and using Apache Xerces.*/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) {　　　　 /** It is safe with an implicit type to assume that the parent* is of type "element", has no "type" attribute, and that we* can derive the type as the value of the element's "name"* attribute with the word "Type" appended to it.*/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();　　　　/** Start writing out the interface and implementation class* definitions.*/interfaceCode.append("public interface ").append(interfaceName);　　　　// Add in extension if appropriateif (baseType != null) {interfaceCode.append(" extends ").append(baseType);}interfaceCode.append(" {

实际上，生成属性和方法是相当简单的。将接口和相应实现的名称添加到类的存储器中，然后是右花括号，它们的作用是结束类。像这样成对生成类，而不是单独生成类，将使同时在接口和实现反映出该过程变得简单。检查源代码（请参阅 参考资料），就可以得到足够的解释。

清单 5中的粗体注释表示源列表中的多行代码。在这里精简代码是为了保持简洁。对于正在创建的 XML schema 的每个特性（由 schema attribute 表示），都会将读方法和写方法添加到接口和实现（实现还有执行方法逻辑的代码）。同时，将为实现类的代码添加变量。

最终结果就是本系列第一部分中生成的类。可以在这里查看它们，或者与本文中的其余代码一起下载（请参阅 参考资料）：

• ServiceConfiguration.java
• ServiceConfigurationImpl.java
• PortType.java
• PortTypeImpl.java
• DocumentType.java
• DocumentTypeImpl.java
• WebServiceConfiguration.java
• WebServiceConfigurationImpl.java

有两个辅助程序类也将参与类生成：

• BindingUtils ，将首字母变成大写。虽然，可以将这个方法添加到生成器类，但我打算以后在打包和解包类时再使用该方法，所以我将它归到这个辅助程序类中。可以 联机查看 BindingUtils ，或者可以 下载它。
• DataMapping ， SchemaMapper 类用来转换数据类型。可以 联机查看源码或者 下载源码。

完成包

如许多其它开放源码软件，在这里显示的数据绑定包是一项正在进行中的工作。虽然它已经初具规模，但仍有很大空间可用于添加更多功能和做改进。因此，以这段代码为基础，可以有许多方式应用程序中加以衍生。

可以重新使用该样本代码，以将 XML schema 的数据约束转换为类型安全的 Java 接口和实现。例如，迄今为止，示例代码还没有处理 XML schema 中可能指定的范围。而对于许多 XML 开发人员，那些数据范围才是使用 schema 的真正原因。然后，请考虑清单 6 中 Web 服务的扩充 XML schema。

清单 6. 带扩充约束的 Web 服务配置

清单 6说明了number属性的类型， 并且在用红色强调的几行中指定了值的合法范围（1 到 32,767）。当前版本的 SchemaMapper 将忽略这些附加声明。从 schema 创建 Java 接口和实现类时，没有必要处理 XML schema 中的 minXXX 和 maxXXX 关键字，但它们可以增加相当多的附加验证。

请查看清单 7 中的代码示例，这些代码是可在实现类中生成的代码，以确保只有 schema 指定范围中的值可以作为变量。

清单 7. 带范围检查的生成代码

public class PortTypeImpl implements PortType {private String protocol;private int number;private String protected;　　　　　　　　　　　　　　　　　　　public void setNumber(int number) {if ((number > 0) && (number <= 32767)) {this.number = number;} else {throw IllegalArgumentException("Argument must be greater than 0and less than or equal to 32767");}}　　　　　　　　　　　　public int getNumber() {return number;}public void setProtocol(String protocol) {this.protocol = protocol;}public String getProtocol() {return protocol;}public void setProtected(String protected) {this.protected = protected;}public String getProtected() {return protected;}}　　　

如果对类提供了非法值，那么清单 7 中的生成代码块将抛出一个运行时异常，这样既确保了类型安全性又确保了范围安全性。

可以很方便地将类似于清单 6 和清单 7 中的增强部分添加到我提供的基本代码中，因为本文中的所有代码完全都是开放源码。您也许还想加入 Enhydra 体系结构工作组邮件发送清单，在该清单中维护和讨论了该代码的未来版本和修订本。可以从 Enhydra Web 站点上加入该清单，列在本文的 参考资料中。

总结

目前为止，应该已经了解什么是数据绑定。已知道使用数据绑定的原因，特别是配置信息。已经掌握如何创建 XML schema 和配置 Web 容器服务的 XML 实例文档，而且我们已经详细讨论了 org.enhydra.xml.binding.SchemaMapper 类。使用这个类，您可以创建 Java 接口和（该接口的）实现，它将管理从 XML 文档创建的 Java 实例。还知道如何将约束从 XML schema 映射到 Java。

现在，已经可以进入下一部分。在下一部分中，将开始把 XML 文档实际转换为 Java 对象的过程，其中 Java 对象是生成类的实例。下一篇文章将说明如何完成这个过程，及其逆向过程，以及 org.enhydra.xml.binding.Unmarshaller 和 org.enhydra.xml.binding.Marshaller 类。这两个类将磁盘上文本的 XML 格式数据移到内存中的 Java 表示，然后再移回来。

希望您能喜欢 XML schema 生成类，下次再见！

以上所有源码均附在文档开始处的源代码下载链接中。