Module  java.xml.bind

Annotation Type XmlTransient



  • @Retention(RUNTIME)
    @Target({字段,METHOD,TYPE})
    public @interface XmlTransient

    防止将JavaBean属性/类型映射到XML表示。

    @XmlTransient注释对于解决JavaBean属性名称和字段名称之间的名称冲突或者阻止字段/属性的映射很有用。 当破译的JavaBean属性名称和字段名称相同时,可能会发生名称冲突。 如果JavaBean属性引用该字段,则可以使用@XmlTransient注释阻止字段或JavaBean属性的映射来解决名称冲突。

    当放在一个类上时,它表示该类本身不应该被映射到XML。 此类的属性将与其派生类一起映射到XML,就好像该类是内联的。

    用法

    @XmlTransient注释可以与以下程序元素一起使用:

    • 一个JavaBean属性
    • 领域

    @XmlTransient与所有其他JAXB定义的注释相互排斥。

    有关其他常见信息,请参阅javax.xml.bind.package javadoc中的“Package Specification”。

    示例:解析JavaBean属性和字段名称之间的名称冲突

      // Example: Code fragment
       public class USAddress {
    
           // The field name "name" collides with the property name
           // obtained by bean decapitalization of getName() below
           @XmlTransient public String name;
    
           String getName() {..};
           String setName() {..};
       }
    
      <!-- Example: XML Schema fragment --> <xs:complexType name="USAddress"> <xs:sequence> <xs:element name="name" type="xs:string"/> </xs:sequence> </xs:complexType>  
    从以下版本开始:
    1.6,JAXB 2.0