Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

35.2. 属性

概述
复制链接

Apache CXF 支持在 complexType 元素的范围内使用属性元素和 attribute Group 元素。当为 XML 文档属性声明定义结构时，提供添加标签中指定的信息的方法，而不是标签包含的值。例如，当描述 XML 元素 <value currency ="euro">410<\value> in XML Schema the currency 属性时，使用 例 35.5 “XML 架构定义和属性” 所示的 attribute 项描述。

attributeGroup 元素允许您定义一组可重复使用的属性，这些属性可以被 schema 定义的所有复杂类型引用。例如，如果您要定义一系列都使用属性类别和 pubDate 的元素，您可以使用这些属性定义属性组，并在所有使用该属性的元素中引用它们。这在 例 35.7 “属性组定义” 中显示。

当描述在开发应用程序逻辑中使用的数据类型时，其 use 属性设置为 optional 或 required 的属性将被视为结构的元素。对于复杂类型描述中包含的每个属性声明，在类中为 属性生成元素，以及适当的 getter 和 setter 方法。

在 XML 架构中定义属性
复制链接

XML Schema 属性 元素具有一个必需属性，名为，用于标识属性。它还有四个可选属性，它们在 表 35.2 “用于定义 XML 架构中属性的可选属性” 中进行了描述。

Expand
表 35.2. 用于定义 XML 架构中属性的可选属性
属性描述

使用

指定是否需要属性。有效值为、 可选 ，或 禁止使用。可选 是默认值。

type

指定属性可以采用的值类型。如果没有使用属性的 schema 类型，则必须在线定义。

default

指定用于属性的默认值。只有在 属性 元素的 use 属性设置为 optional 时，才会使用它。

已修复

指定用于属性的固定值。只有在 属性 元素的 use 属性设置为 optional 时，才会使用它。

例 35.5 “XML 架构定义和属性” 显示一个属性元素，定义属性 currency，其值为字符串。

例 35.5. XML 架构定义和属性

<element name="value">
  <complexType>
    <xsd:simpleContent>
      <xsd:extension base="xsd:integer">
        <xsd:attribute name="currency" type="xsd:string"
                       use="required"/>
      </xsd:extension>
    </xsd:simpleContent>
  </xsd:complexType>
</xsd:element>
Copy to Clipboard Toggle word wrap

如果在 attribute 元素中省略了 type 属性，则必须使用命令行描述数据格式。例 35.6 “带有 In-Line Data Description 的属性” 显示 属性 ( category )的一个属性元素，它可以取值 autobiography、non-fiction 或 fiction。

例 35.6. 带有 In-Line Data Description 的属性

<attribute name="category" use="required">
  <simpleType>
    <restriction base="xsd:string">
      <enumeration value="autobiography"/>
      <enumeration value="non-fiction"/>
      <enumeration value="fiction"/>
    </restriction>
  </simpleType>
</attribute>
Copy to Clipboard Toggle word wrap

在 XML Schema 中使用属性组
复制链接

在复杂类型定义中使用属性组分为两个步骤：

  1. 定义属性 group。

    属性组使用带有多个属性子元素的 attribute Group 元素来定义。attributeGroup 需要一个 name 属性，用于定义用于引用属性组的字符串。属性 元素定义属性组的成员，并如 “在 XML 架构中定义属性”一节 所示指定。例 35.7 “属性组定义” 显示属性组 catalogIndecies 的描述。属性组有两个成员： 类别，它是可选的，而 pubDate 是必需的。

    例 35.7. 属性组定义

    <attributeGroup name="catalogIndices">
  <attribute name="category" type="catagoryType" />
  <attribute name="pubDate" type="dateTime"
             use="required" />
</attributeGroup>
    Copy to Clipboard Toggle word wrap

  2. 在复杂类型的定义中使用属性组。

    您可以使用 attributeGroup 元素和 ref 属性在复杂类型定义中使用属性组。ref 属性的值是给定您要用作类型定义一部分的属性组的名称。例如，如果要使用复杂类型 dvdType 中的属性组 catalogIndecies，您可以使用 <attributeGroup ref="catalogIndecies" />，如 例 35.8 “具有属性组的复杂类型” 所示。

    例 35.8. 具有属性组的复杂类型

    <complexType name="dvdType">
  <sequence>
    <element name="title" type="xsd:string" />
    <element name="director" type="xsd:string" />
    <element name="numCopies" type="xsd:int" />
  </sequence>
  <attributeGroup ref="catalogIndices" />
</complexType>
    Copy to Clipboard Toggle word wrap

将属性映射到 Java
复制链接

属性与 member 元素映射到 Java 非常相似。必要属性和可选属性映射到生成的 Java 类中的成员变量。成员变量使用 @XmlAttribute 注释进行解码。如果需要该属性，则 @XmlAttribute 注释的 required 属性设置为 true。

例 35.9 “techdoc Description” 中定义的复杂类型映射到 例 35.10 “techdoc Java Class” 中显示的 Java 类。

例 35.9. techdoc Description

<complexType name="techDoc">
  <all>
    <element name="product" type="xsd:string" />
    <element name="version" type="xsd:short" />
  </all>
  <attribute name="usefullness" type="xsd:float"
             use="optional" default="0.01" />
</complexType>
Copy to Clipboard Toggle word wrap

例 35.10. techdoc Java Class

@XmlType(name = "techDoc", propOrder = {

})
public class TechDoc {

    @XmlElement(required = true)
    protected String product;
    protected short version;
    @XmlAttribute protected Float usefullness;

    public String getProduct() {
        return product;
    }

    public void setProduct(String value) {
        this.product = value;
    }

    public short getVersion() {
        return version;
    }

    public void setVersion(short value) {
        this.version = value;
    }

    public float getUsefullness() { if (usefullness == null) { return 0.01F; } else { return usefullness; } }

    public void setUsefullness(Float value) {
        this.usefullness = value;
    }
}
Copy to Clipboard Toggle word wrap

如 例 35.10 “techdoc Java Class” 中所示，default 属性和 fixed 属性指示代码生成器将代码添加到为属性生成的 getter 方法中。此额外代码可确保如果没有设置值，则返回指定的值。

重要

fixed 属性被视为与 default 属性相同。如果您希望 固定 属性被视为 Java 常数，您可以使用 第 38.5 节 “自定义修复的值属性映射” 中描述的自定义。

将属性组映射到 Java
复制链接

属性组映射到 Java，就像类型定义中明确使用组成员一样。如果属性组有三个成员，且在复杂类型中使用，则该类型生成的类将包含 member 变量，以及 attribute 组的每个成员的 getter 和 setter 方法。例如，例 35.8 “具有属性组的复杂类型” 中定义的复杂类型，Apache CXF 会生成一个包含成员变量 类别和 pubDate 的类，以支持属性组的成员，如 例 35.11 “dvdType Java Class” 所示。

例 35.11. dvdType Java Class

@XmlType(name = "dvdType", propOrder = {
    "title",
    "director",
    "numCopies"
})
public class DvdType {

    @XmlElement(required = true)
    protected String title;
    @XmlElement(required = true)
    protected String director;
    protected int numCopies;
    @XmlAttribute protected CatagoryType category; @XmlAttribute(required = true) @XmlSchemaType(name = "dateTime") protected XMLGregorianCalendar pubDate;

    public String getTitle() {
        return title;
    }

    public void setTitle(String value) {
        this.title = value;
    }

    public String getDirector() {
        return director;
    }

    public void setDirector(String value) {
        this.director = value;
    }

    public int getNumCopies() {
        return numCopies;
    }

    public void setNumCopies(int value) {
        this.numCopies = value;
    }

    public CatagoryType getCatagory() {
        return catagory;
    }

    public void setCatagory(CatagoryType value) {
        this.catagory = value;
    }

    public XMLGregorianCalendar getPubDate() {
        return pubDate;
    }

    public void setPubDate(XMLGregorianCalendar value) {
        this.pubDate = value;
    }

}
Copy to Clipboard Toggle word wrap
返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务，以及可以信赖的内容，帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情，请参阅红帽博客.

關於紅帽

我们提供强化的解决方案，使企业能够更轻松地跨平台和环境（从核心数据中心到网络边缘）工作。

Theme

© 2025 Red Hat