Javax @XmlTransient注解作用于枚举字段不生效问题解决

@XmlTransient 标注在枚举常量上时，仅会拦截该常量的序列化、反序列化行为，不会在XML Schema自动生成阶段过滤对应的枚举项，这是JDK内置JAXB实现的默认处理逻辑，所以直接给C加注解无法达到预期的XSD生成效果。

方案1：手写XSD文件（最直接） #

如果你的业务场景不需要动态生成Schema，完全可以直接编写符合预期的XSD文件，做XML校验、JAXB绑定时直接引用这份手写的XSD即可，不需要依赖JAXB自动生成逻辑，能100%控制对外暴露的枚举范围，最终效果和你期望的完全一致。

方案2：自定义注解+Schema生成过滤逻辑 #

如果必须动态生成Schema，可以通过自定义注解标记内部枚举值，在生成Schema环节做过滤：

1. 先定义内部枚举标记注解

   import java.lang.annotation.*;
   
   @Retention(RetentionPolicy.RUNTIME)
   @Target(ElementType.FIELD)
   public @interface InternalEnum {
   }
   

2. 给内部使用的枚举值加上该注解

   public enum Test {
       A,
       B,
       @InternalEnum
       C
   }
   

3. 重写Schema生成时的枚举遍历逻辑：在生成xs:simpleType下的xs:enumeration节点前，通过反射检查每个枚举常量是否带有@InternalEnum注解，带注解的常量直接跳过，不生成对应的枚举节点，最终输出的XSD就只会保留A、B两个枚举项。
   同时可以配套自定义XmlAdapter，拦截C值的序列化/反序列化逻辑，避免内部枚举值被对外输出或被外部传入。

   import javax.xml.bind.annotation.adapters.XmlAdapter;
   
   public class TestAdapter extends XmlAdapter<String, Test> {
       @Override
       public Test unmarshal(String value) {
           if ("A".equals(value)) return Test.A;
           if ("B".equals(value)) return Test.B;
           throw new IllegalArgumentException("不支持的枚举值：" + value);
       }
   
       @Override
       public String marshal(Test test) {
           if (test == Test.C) {
               throw new IllegalArgumentException("内部枚举值禁止对外序列化");
           }
           return test.name();
       }
   }
   

补充说明 #

如果你使用的是EclipseLink JAXB（MOXy）实现，原生支持在枚举常量上添加@XmlTransient注解，自动在生成的Schema中过滤对应枚举项，不需要额外写自定义逻辑；但JDK内置的默认JAXB实现不支持该特性。

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