javax.xml.bind.annotation

Annotation Type XmlTransient

@Retention(value=RUNTIME)
 @Target(value={字段,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> 

从以下版本开始：

JAXB2.0