第 35 章 使用复杂类型
摘要
复杂的类型可以包含多个元素,它们可以包含属性。它们映射到可存放类型定义所代表数据的 Java 类。通常,映射是指包含一组代表元素和内容模型属性的属性的 bean。
35.1. 基本复杂类型映射
概述
XML 架构复杂类型定义包含比简单类型更复杂信息的构造。最简单的复杂类型定义一个带有属性的空元素。更复杂的复杂类型由一组元素组成。
默认情况下,XML Schema 复杂类型映射到 Java 类,具有代表 XML 架构定义中列出的每个元素和属性的成员变量。该类为每个成员变量有 setters 和 getters。
在 XML 架构中定义
XML 架构复杂的类型是使用 complexType
元素定义的。complexType
元素嵌套了用来定义数据结构的其余元素。它可以显示为指定类型定义的父元素,也可以作为元素的子元素匿名定义存储在元素中的信息结构。当使用
complexType
元素来定义命名类型时,它需要使用 name
属性。name
属性指定引用类型的唯一标识符。
包含一个或多个元素的复杂类型定义具有 表 35.1 “定义元素在复杂类型中如何应用元素的元素” 中描述的子元素之一。这些元素决定了指定元素在类型的实例中如何出现。
元素 | 描述 |
---|---|
| 作为复杂类型一部分定义的所有元素都必须出现在类型的实例中。但是,它们可能会以任何顺序出现。 |
| 只有作为复杂类型一部分定义的一个元素才能出现在类型的实例中。 |
| 作为复杂类型一部分定义的所有元素必须出现在类型的实例中,它们也必须按照类型定义中指定的顺序出现。 |
如果复杂的类型定义只使用属性,则不需要 表 35.1 “定义元素在复杂类型中如何应用元素的元素” 中描述的元素之一。
在决定如何出现元素后,您可以通过向定义中添加一个或多个 元素
子来定义元素。
例 35.1 “XML Schema Complex Type” 显示了 XML 架构中的复杂类型定义。
例 35.1. XML Schema Complex Type
<complexType name="sequence"> <sequence> <element name="name" type="xsd:string" /> <element name="street" type="xsd:short" /> <element name="city" type="xsd:string" /> <element name="state" type="xsd:string" /> <element name="zipCode" type="xsd:string" /> </sequence> </complexType>
映射到 Java
XML 架构复杂类型映射到 Java 类。复杂类型定义中的每个元素都映射到 Java 类中的成员变量。此外,还会为复杂类型中的每个元素生成 getter 和 setter 方法。
所有生成的 Java 类均带有 @XmlType
注释进行解码。如果映射适用于命名复杂类型,则注解 名称
将设置为 complexType
元素的 name
属性的值。如果复杂的类型是作为元素定义的一部分,则 @XmlType
注释的 name
属性的值是 元素的
name
属性的值。
如 “具有内线类型的元素的 Java 映射”一节 所述,如果为作为元素定义的一部分定义的复杂类型生成,生成的类会与 @XmlRootElement
注释进行解码。
为了提供运行时,以指示应如何处理 XML 架构复杂类型元素,代码生成器会更改用于分离类及其成员变量的注解。
- 所有复杂类型
所有复杂的类型都使用
all
元素来定义。它们注解如下:-
@XmlType
注释的propOrder
属性为空。 -
每个元素都会使用
@XmlElement
注释进行解码。 @XmlElement
注释的required
属性设置为true
。例 35.2 “所有复杂类型的映射” 显示所有复杂类型以及两个元素的映射。
例 35.2. 所有复杂类型的映射
@XmlType(name = "all", propOrder = { }) public class All { @XmlElement(required = true) protected BigDecimal amount; @XmlElement(required = true) protected String type; public BigDecimal getAmount() { return amount; } public void setAmount(BigDecimal value) { this.amount = value; } public String getType() { return type; } public void setType(String value) { this.type = value; } }
-
- Choice Complex Type
选择复杂类型通过选择元素来定义。
它们注解如下:
-
@XmlType
注释的propOrder
属性根据它们出现在 XML 架构定义中的顺序列出元素名称。 没有注解成员变量。
例 35.3 “选择复杂类型的映射” 显示了选择复杂类型的映射,以及两个元素。
例 35.3. 选择复杂类型的映射
@XmlType(name = "choice", propOrder = { "address", "floater" }) public class Choice { protected Sequence address; protected Float floater; public Sequence getAddress() { return address; } public void setAddress(Sequence value) { this.address = value; } public Float getFloater() { return floater; } public void setFloater(Float value) { this.floater = value; } }
-
- 序列复杂类型
使用
sequence
元素定义序列复杂类型。它注解如下:-
@XmlType
注释的propOrder
属性根据它们出现在 XML 架构定义中的顺序列出元素名称。 -
每个元素都会使用
@XmlElement
注释进行解码。 @XmlElement
注释的required
属性设置为true
。例 35.4 “复杂类型映射” 显示 例 35.1 “XML Schema Complex Type” 中定义的复杂类型的映射。
例 35.4. 复杂类型映射
@XmlType(name = "sequence", propOrder = { "name", "street", "city", "state", "zipCode" }) public class Sequence { @XmlElement(required = true) protected String name; protected short street; @XmlElement(required = true) protected String city; @XmlElement(required = true) protected String state; @XmlElement(required = true) protected String zipCode; public String getName() { return name; } public void setName(String value) { this.name = value; } public short getStreet() { return street; } public void setStreet(short value) { this.street = value; } public String getCity() { return city; } public void setCity(String value) { this.city = value; } public String getState() { return state; } public void setState(String value) { this.state = value; } public String getZipCode() { return zipCode; } public void setZipCode(String value) { this.zipCode = value; } }
-