JAXB无法从嵌套在xsd:element中的XSD简单类型生成枚举类

这不是xjc的问题，是XSD结构变化触发了JAXB的默认生成逻辑。

原因分析 #

• 旧版XSD中，xsd:simpleType是全局独立定义的（比如PriorityEnum），通过type属性引用时，JAXB会识别这是一个可复用的类型，自动生成对应的枚举类，字段类型自然就是该枚举。
• 新版XSD把xsd:simpleType嵌套在xsd:element内部，此时这个简单类型是该element的局部类型，不属于全局可复用的类型集合。当你用ref引用这个element时，xjc默认只会为该字段生成String类型——因为局部嵌套的简单类型不会被单独提取为枚举类。

解决办法 #

• 调整XSD结构（推荐）：把嵌套在element里的xsd:simpleType提取为全局类型（移到xsd:schema根节点下，给它指定name），然后让element通过type属性引用这个全局类型。这样xjc会重新生成对应的枚举类，字段类型也会变回枚举。
• 使用JAXB绑定文件：如果无法修改XSD，可以编写binding.xjb文件，显式指定将嵌套的简单类型映射为枚举类。示例绑定配置：

  <jaxb:bindings xmlns:jaxb="http://java.sun.com/xml/ns/jaxb" version="2.3">
      <jaxb:bindings schemaLocation="your-schema.xsd" node="//xsd:element[@name='priority']/xsd:simpleType">
          <jaxb:typesafeEnumClass name="PriorityEnum"/>
      </jaxb:bindings>
  </jaxb:bindings>
  

  然后在build.gradle中配置xjc任务引入这个绑定文件。
• 手动修改生成代码（不推荐）：每次生成后手动把字段类型从String改成枚举，但后续重新生成代码会覆盖修改，维护成本高。

内容的提问来源于stack exchange，提问作者Noel93