@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 может использоваться со следующими элементами программы:
@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>
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92