36.3. 使用 Unbound 属性

概述

XML 架构有一个机制,允许您在复杂类型定义中保留任意属性的拥有者。通过使用这种机制,您可以定义可以具有任何属性的复杂类型。例如,您可以创建一个类型来定义元素 <robot name="epsilon" />、<robot age="10000" /> 或 <robot type="weevil" /> 而不指定三个属性。这在您的数据中的灵活性需要时特别有用。

在 XML 架构中定义

Undeclared 属性在 XML 架构中使用 anyAttribute 元素定义。它可用于在可以使用属性元素的位置。anyAttribute 元素没有属性,如 例 36.7 “带有 Undeclared Attribute 的复杂类型” 所示。

例 36.7. 带有 Undeclared Attribute 的复杂类型

<complexType name="arbitter">
  <sequence>
    <element name="name" type="xsd:string" />
    <element name="rate" type="xsd:float" />
  </sequence>
  <anyAttribute />
</complexType>

定义的类型 arbitter 具有两个元素,并可具有任何类型的一个属性。例 36.8 “使用通配符属性定义的元素示例” 中显示的元素有三个元素,它们都可以从复杂的类型 arbitter 生成。

例 36.8. 使用通配符属性定义的元素示例

<officer rank="12"><name>...</name><rate>...</rate></officer>
<lawyer type="divorce"><name>...</name><rate>...</rate></lawyer>
<judge><name>...</name><rate>...</rate></judge>

映射到 Java

当包含 任何Attribute 元素的复杂类型映射到 Java 时,代码生成器会将名为 otherAttributes 的成员添加到生成的类。otherAttributesjava.util.Map<QName, String >,它是一种 getter 方法,它返回了映射的实时实例。由于 getter 返回的映射是实时的,对映射的任何修改都会被自动应用。例 36.9 “带有 Undeclared Attribute 的复杂类型” 显示为 例 36.7 “带有 Undeclared Attribute 的复杂类型” 中定义的复杂类型生成的类。

例 36.9. 带有 Undeclared Attribute 的复杂类型

public class Arbitter {

    @XmlElement(required = true)
    protected String name;
    protected float rate;

    @XmlAnyAttribute private Map<QName, String> otherAttributes = new HashMap<QName, String>();

    public String getName() {
        return name;
    }

    public void setName(String value) {
        this.name = value;
    }

    public float getRate() {
        return rate;
    }

    public void setRate(float value) {
        this.rate = value;
    }

    public Map<QName, String> getOtherAttributes() { return otherAttributes; }

}

使用未压缩属性

生成的类 的另一个Attributes 成员应该被填充到 Map 对象。该映射使用 QNames 键。获取映射后,您可以访问对象上设置的任何属性,并在对象上设置新属性。

例 36.10 “使用 Undeclared Attributes” 显示使用未压缩属性的代码示例。

例 36.10. 使用 Undeclared Attributes

Arbitter judge = new Arbitter();
Map<QName, String> otherAtts = judge.getOtherAttributes();

QName at1 = new QName("test.apache.org", "house");
QName at2 = new QName("test.apache.org", "veteran");

otherAtts.put(at1, "Cape");
otherAtts.put(at2, "false");

String vetStatus = otherAtts.get(at2);

例 36.10 “使用 Undeclared Attributes” 中的代码执行以下操作:

获取含有未压缩属性的 map。

创建 QName 以用于属性。

将属性的值设置为映射。

检索其中一个属性的值。