38.3. 为简单类型生成 Java 类

概述

默认情况下,命名的简单类型不会产生生成的类型,除非它们是枚举。使用简单类型定义的元素映射到 Java 原语类型的属性。

如果需要将简单类型生成到 Java 类,比如您希望使用类型替换时,会有一些实例。

要指示代码生成器为所有全局定义的简单类型生成类,请将 globalBindings 自定义元素的 mapSimpleTypeDef 设置为 true

添加自定义

要指示代码生成器为命名简单类型创建 Java 类,请添加 globalBinding 元素的 mapSimpleTypeDef 属性,并将其值设为 true

例 38.13 “为 SimpleTypes 强制生成 Java 类自定义” 显示行自定义,它强制代码生成器为命名的简单类型生成 Java 类。

例 38.13. 为 SimpleTypes 强制生成 Java 类自定义

<schema targetNamespace="http://widget.com/types/widgetTypes"
        xmlns="http://www.w3.org/2001/XMLSchema"
        xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
        xmlns:jaxb="http://java.sun.com/xml/ns/jaxb"
        jaxb:version="2.0">
  <annotation>
    <appinfo>
      <jaxb:globalBindings mapSimpleTypeDef="true" />
    </appinfo>
  </annotation>
  ...
</schema>

例 38.14 “绑定文件以强制生成 Constants” 显示用于自定义生成简单类型的外部绑定文件。

例 38.14. 绑定文件以强制生成 Constants

<jaxb:bindings xmlns:jaxb="http://java.sun.com/xml/ns/jaxb"
               xmlns:xsd="http://www.w3.org/2001/XMLSchema"
               jaxb:version="2.0">
  <jaxb:bindings schemaLocation="types.xsd">
    <jaxb:globalBindings mapSimpleTypeDef="true" />
  <jaxb:bindings>
<jaxb:bindings>
重要

此自定义仅影响在 全局范围 中定义的 指定 简单类型。

生成的类

为简单类型生成的类具有一个称为 value 的属性。value 属性是由 第 34.1 节 “原语类型” 中映射定义的 Java 类型。生成的类具有 getter 和 value 属性的 setter。

例 38.16 “简单类型的自定义映射” 显示为 例 38.15 “自定义映射的简单类型” 中定义的简单类型生成的 Java 类。

例 38.15. 自定义映射的简单类型

<simpleType name="simpleton">
  <restriction base="xsd:string">
    <maxLength value="10"/>
  </restriction>
</simpleType>

例 38.16. 简单类型的自定义映射

@XmlAccessorType(XmlAccessType.FIELD)
@XmlType(name = "simpleton", propOrder = {"value"})
public class Simpleton {

    @XmlValue
    protected String value;

    public String getValue() {
        return value;
    }

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

}