38.2. 指定 XML 架构 Primitive 的 Java 类

默认情况下，XML 架构类型映射到 Java 原语类型。虽然这是 XML 架构和 Java 之间的最逻辑映射，但它并不总是满足应用程序开发人员的要求。您可能希望将 XML 架构原语类型映射到可保存额外信息的 Java 类，或者您可能希望将 XML 原语类型映射到允许简单类型替换的类。

JAXB javaType 自定义元素允许您自定义 XML 架构原语类型和 Java 原语类型之间的映射。它可用于自定义全局级别和单个实例级别的映射。您可以使用 javaType 元素作为简单类型定义的一部分，或作为复杂类型定义的一部分。

在使用 javaType 自定义元素时，您必须指定将 primitive 类型的 XML 表示转换为目标 Java 类的方法。有些映射有默认的转换方法。对于没有默认映射的实例，Apache CXF 提供了 JAXB 方法来简化所需方法的开发。

javaType 自定义元素采用四个属性，如 表 38.1 “为 XML 架构类型自定义 Java 类的 Generation 的属性” 所述。

javaType 自定义元素可通过三种方式使用：

Apache CXF 无法将 XML 架构原语类型转换为随机 Java 类。当您使用 javaType 元素自定义 XML Schema 原语类型的映射时，代码生成器会创建一个适配器类，用于 marshal 和 unmarshal 自定义 XML 架构原语类型。例 38.10 “JAXB Adapter 类” 中显示示例适配器类。

public class Adapter1 extends XmlAdapter<String, javaType>
{
  public javaType unmarshal(String value)
  {
    return(parseMethod(value));
  }

  public String marshal(javaType value)
  {
    return(printMethod(value));
  }
}

parseMethod 和 printMethod 被对应的 parseMethod 属性和 printMethod 属性的值替代。值必须识别有效的 Java 方法。您可以通过以下两种方式之一指定方法的名称：

如果没有提供 parseMethod 属性的值，则代码生成器假定 name 属性指定的 Java 类具有构造器，其第一个参数是一个 Java String 对象。生成的适配器的 unmarshal （） 方法使用假定的构造器使用 XML 数据填充 Java 对象。

如果没有提供 printMethod 属性的值，则代码生成器假定 name 属性指定的 Java 类具有 toString （） 方法。生成的适配器的 marshal （） 方法使用假定的 toString （） 方法将 Java 对象转换为 XML 数据。

如果 javaType 元素的 name 属性指定 Java 原语类型，或者 Java 原语的打包程序类型之一，则代码生成器使用默认的转换器。有关默认转换器的详情请参考 “默认原语类型转换器”一节。

如 “指定转换器”一节 所述，使用 javaType customization 元素为每个自定义 XML 架构原语类型触发一个适配器类的生成。适配器按顺序使用 pattern AdapterN 命名。如果您指定了两个原语类型自定义，则代码生成器会创建两个适配器类： Adapter1 和 Adapter2。

为 XML 模式构建生成的代码取决于效果的 XML 架构结构是全局定义的元素，或者被定义为复杂类型的一部分。

当 XML Schema 结构是全局定义的元素时，为类型生成的对象工厂方法将从默认方法修改，如下所示：

例 38.11 “全局元素的自定义对象工厂方法” 显示受 例 38.7 “全局原语类型自定义” 中显示的自定义影响的元素的对象工厂方法。

 @XmlElementDecl(namespace = "http://widgetVendor.com/types/widgetTypes", name = "shorty")
 @XmlJavaTypeAdapter(org.w3._2001.xmlschema.Adapter1.class)
 public JAXBElement<Integer> createShorty(Integer value) {
     return new JAXBElement<Integer>(_Shorty_QNAME, Integer.class, null, value);
 }

当将 XML Schema 结构定义为复杂类型的一部分时，生成的 Java 属性将修改，如下所示：

例 38.12 “自定义复杂类型” 显示受 例 38.7 “全局原语类型自定义” 中显示的自定义影响的元素的对象工厂方法。

public class NumInventory {

    @XmlElement(required = true, type = String.class) @XmlJavaTypeAdapter(Adapter1.class) @XmlSchemaType(name = "short") protected Integer numLeft;
    @XmlElement(required = true)
    protected String size;

    public Integer getNumLeft() {
        return numLeft;
    }

    public void setNumLeft(Integer value) {
        this.numLeft = value;
    }

    public String getSize() {
        return size;
    }

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

}

Apache CXF 运行时不知道如何将 XML 原语类型转换为 javaType 元素指定的 Java 类，但它应调用 parseMethod 属性和 printMethod 属性指定的方法。您负责提供方法运行时调用的实现。实施的方法必须能够使用 XML 原语类型的字典结构。

为简化数据转换方法的实现，Apache CXF 提供 javax.xml.bind.DatatypeConverter 类。此类提供解析和打印所有 XML 架构原语类型的方法。parse 方法使用 XML 数据的字符串表示，它们会返回 表 34.1 “XML Schema 原语类型到 Java 原生类型映射” 中定义的默认类型实例。打印方法采用默认类型的实例，它们返回 XML 数据的字符串表示。

DatatypeConverter 类的 Java 文档可在 https://docs.oracle.com/javase/8/docs/api/javax/xml/bind/DatatypeConverter.html 中找到。

在 javaType 元素的 name 属性中指定 Java 原语类型或 Java 原语类型 Wrapper 类时，不需要为 parseMethod 属性或 printMethod 属性指定值。如果没有提供任何值，Apache CXF 运行时会替换默认的转换器。

默认数据转换器使用 JAXB DatatypeConverter 类来解析 XML 数据。默认转换器还会提供进行转换所需的任何类型广播。