能否将模式限制的simpleType映射为枚举类？JAXB绑定报错求解

问题背景 #

你定义了一个带xs:pattern限制的simpleType：

<xs:simpleType name="exampleType">
    <xs:restriction base="xs:string">
        <xs:pattern value="\d{3,6}"/>
    </xs:restriction>
</xs:simpleType>

尝试通过JAXB绑定将其映射为基于规范文档的枚举类：

<jaxb:bindings node="//xs:simpleType[@name='ExampleType']">
  <jaxb:typesafeEnumClass name="EnumExample">
    <jaxb:typesafeEnumMember value="1" name="description_1" />
    ....
  </jaxb:typesafeEnumClass>
</jaxb:bindings>

但触发报错：

com.sun.istack.SAXParseException2: enum class customization is specified on a type that has no enumeration facet.

报错原因 #

JAXB的typesafeEnumClass定制仅支持包含xs:enumeration约束的simpleType，你的原XSD只有xs:pattern限制，没有枚举项，因此无法直接使用该定制。

可行方案 #

方案1：修改XSD，添加枚举约束

如果允许修改XSD，直接将规范文档中的枚举值添加到xs:restriction中，同时保留xs:pattern做额外验证：

<xs:simpleType name="exampleType">
    <xs:restriction base="xs:string">
        <xs:pattern value="\d{3,6}"/>
        <xs:enumeration value="123"/>
        <xs:enumeration value="4567"/>
        <!-- 补充规范文档中所有枚举值 -->
    </xs:restriction>
</xs:simpleType>

此时JAXB会自动识别枚举项生成枚举类，也可以通过绑定指定枚举类名称：

<jaxb:bindings node="//xs:simpleType[@name='exampleType']">
  <jaxb:typesafeEnumClass name="EnumExample"/>
</jaxb:bindings>

方案2：使用XmlAdapter自定义映射（无需修改XSD）

如果无法修改XSD，可通过自定义XmlAdapter实现字符串到枚举的转换，同时保留模式验证：

1. 手动编写枚举类

public enum EnumExample {
    DESCRIPTION_1("123"),
    DESCRIPTION_2("4567"),
    // 补充规范文档中所有枚举项
    ;

    private final String value;

    EnumExample(String value) {
        this.value = value;
    }

    public String getValue() {
        return value;
    }

    // 根据值查找枚举实例
    public static EnumExample valueOfByValue(String value) {
        for (EnumExample e : EnumExample.values()) {
            if (e.value.equals(value)) {
                return e;
            }
        }
        throw new IllegalArgumentException("Unknown value: " + value);
    }
}

2. 编写XmlAdapter

public class ExampleTypeAdapter extends XmlAdapter<String, EnumExample> {
    @Override
    public EnumExample unmarshal(String value) throws Exception {
        // 验证值是否符合模式约束
        if (!value.matches("\\d{3,6}")) {
            throw new IllegalArgumentException("Value does not match pattern \\d{3,6}: " + value);
        }
        return EnumExample.valueOfByValue(value);
    }

    @Override
    public String marshal(EnumExample enumValue) throws Exception {
        return enumValue.getValue();
    }
}

3. 在JAXB绑定中指定适配器

<jaxb:bindings node="//xs:simpleType[@name='exampleType']">
    <jaxb:javaType name="com.yourpackage.EnumExample" adapter="com.yourpackage.ExampleTypeAdapter"/>
</jaxb:bindings>

生成的类会自动使用该适配器完成类型转换，同时保留模式验证逻辑。

内容的提问来源于stack exchange，提问作者Reto Höhener