配置XMLBeans.doc

配置XMLBeans 摘要　　XMLBeans 1.0.3最强大的功能之一是可通过提供配置文件定制代码生成。在灵活性、可重用性、简化代码和维护方面，XMLBeans的功能带来了许多益处。因为任何企业应用程序相当大部分的成本都在于维护方面，所以从长远来看，XMLBeans的配置功能能够代表对成本和时间的节省。　　本文通过一系列的示例对这些功能进行了说明。我们假设您已熟悉XMLBeans。对于入门者，参见下面列出的介绍XMLBeans的文章。本文中提及的示例代码和其他文件可以下载。示例已在Apache XMLBeans 1.0.3、Java 1.4.2_02和Microsoft Windows 2000上通过测试。简介　　运行XMLBeans编译器时，可以指定可选配置文件来修正XMLBeans生成器的行为。默认情况下，该配置文件应当具有.xsdconfig扩展名。配置文件的结构遵循以下模式： ?xml version=1.0 encoding=UTF-8? xb:config xmlns:xb=/xmlbeans/2004/02/xbean/config ... /xb:config 　　正如您所看到的，根config元素必须位于/xmlbeans/2004/02/xbean/config名称空间中。真正的配置功能必须位于config元素之内，可按任何次序排放。　　有了模式文件（比如someSchema.xsd）和配置文件（比如someConfig.xsdconfig）之后，下一步即是生成一系列代表该模式的XMLBeans类。以下为命令行用法示例： scomp -out output_XmlBeans.jar someSchema.xsd someConfig.xsdconfig 　　注意配置文件只是简单添加到scomp的附加参数。这将确保生成器使用您所指定的任何扩展功能。以下部分对这些功能依次进行了检查。向已生成的类名添加前缀或后缀　　XMLBeans提供了简单配置功能，用于从特定的名称空间中为模式类型创建的XMLBeans类名添加前缀名及后缀名。该功能对于将从特定名称空间中生成的模式类型的XMLBeans类同其他XMLBeans和在工程中使用的JavaBeans区别开来很有用。　　这只是最简单的功能。我们在介绍模式示例时将还会使用这一部分。清单1显示了贯穿本文使用的localInfo.xsd模式。它描述了包含一个地点（基于邮编）天气信息的XML文档。清单1. localInfo.xsd xsd:schema targetNamespace=http://www.localI/LI ... xmlns:ns1 = http://www.helloW/weather xsd:import namespace=http://www.helloW/weather schemaLocation=weather.xsd/ xsd:element name=localInfo xsd:complexType xsd:sequence xsd:element ref=ns1:localWeather/ /xsd:sequence xsd:attribute ref=Zipcode/ /xsd:complexType /xsd:element xsd:attribute name=Zipcode type=xsd:string/ /xsd:schema 　　该localInfo.xsd 模式导入 weather.xsd，如清单2所示。清单 2. weather.xsd xsd:schema targetNamespace= http://www.helloW/weather .... xsd:element name=localWeather xsd:complexType xsd:sequence xsd:element ref=Temperature/ xsd:element ref=Humidity / xsd:element ref=Visibility / xsd:element ref=Datetime / xsd:element ref=image minOccurs=1 maxOccurs=1/ /xsd:sequence xsd:attribute ref=Zipcode/ /xsd:complexType /xsd:element xsd:element name=Temperature type=xsd:float/ xsd:element name=Humidity