Spec-Zone .ru спецификации, руководства, описания, API

javax.xml.bind.annotation
Тип аннотации XmlTransient

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

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

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

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

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

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

• свойство JavaBean
• поле
• class

@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

Автор:

Sekhar Vajjhala, Sun Microsystems, Inc.