Тип аннотации XmlTransient

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

Препятствует отображению свойства/типа JavaBean в XML-представлении.

Аннотация @XmlTransient полезна для разрешения коллизий имен между именем свойства JavaBean и именем поля или предотвращения отображения поля/свойства. Коллизия имен может произойти, когда декапитализированное имя свойства JavaBean и имя поля совпадают. Если свойство JavaBean ссылается на поле, то конфликт имен можно разрешить, предотвратив отображение либо поля, либо свойства JavaBean с помощью аннотации @XmlTransient.

При размещении на классе она указывает, что класс не должен отображаться в XML сам по себе. Свойства такого класса будут отображаться в XML вместе с его производными классами, как если бы класс был встроен.

Использование

Аннотация @XmlTransient может использоваться со следующими элементами программы:

• свойство JavaBean
• поле
• класс

@XmlTransient является взаимоисключающей со всеми другими аннотациями, определёнными JAXB.

См. "Спецификацию пакета" в документации javax.xml.bind.package для дополнительной общей информации.

Пример: Разрешение коллизии имен между именем свойства 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>