javax.xml.bind.annotation
类 XmlTransient

@Retention(value=RUNTIME)
@Target(value={FIELD,METHOD})
public @interface XmlTransient

阻止将 JavaBean 属性映射到 XML 表示形式。

@XmlTransient 注释对于解决 JavaBean 属性名称与字段名称之间的名称冲突，或者用于防止字段/属性的映射。当取消首字母大写的 JavaBean 属性名称与字段名称相同时，就可能发生名称冲突。如果 JavaBean 属性引用该字段，那么可以通过防止映射使用 @XmlTransient 注释的字段或 JavaBean 属性来解决名称冲突。

用法

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

• JavaBean 属性
• 字段

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

有关其他公共消息，请参阅 javax.xml.bind.package javadoc 中的“包规范”。

示例：解决 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