< prev index next >
src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlTransient.java
Print this page
*** 32,65 ****
/**
* <p>
* Prevents the mapping of a JavaBean property/type to XML representation.
* <p>
! * The <tt>@XmlTransient</tt> annotation is useful for resolving name
* collisions between a JavaBean property name and a field name or
* preventing the mapping of a field/property. A name collision can
* occur when the decapitalized JavaBean property name and a field
* name are the same. If the JavaBean property refers to the field,
* then the name collision can be resolved by preventing the
* mapping of either the field or the JavaBean property using the
! * <tt>@XmlTransient</tt> annotation.
*
* <p>
* When placed on a class, it indicates that the class shouldn't be mapped
* to XML by itself. Properties on such class will be mapped to XML along
* with its derived classes, as if the class is inlined.
*
* <p><b>Usage</b></p>
! * <p> The <tt>@XmlTransient</tt> annotation can be used with the following
* program elements:
* <ul>
* <li> a JavaBean property </li>
* <li> field </li>
* <li> class </li>
* </ul>
*
! * <p><tt>@XmlTransient</tt>is mutually exclusive with all other
* JAXB defined annotations. </p>
*
* <p>See "Package Specification" in javax.xml.bind.package javadoc for
* additional common information.</p>
*
--- 32,65 ----
/**
* <p>
* Prevents the mapping of a JavaBean property/type to XML representation.
* <p>
! * The {@code @XmlTransient} annotation is useful for resolving name
* collisions between a JavaBean property name and a field name or
* preventing the mapping of a field/property. A name collision can
* occur when the decapitalized JavaBean property name and a field
* name are the same. If the JavaBean property refers to the field,
* then the name collision can be resolved by preventing the
* mapping of either the field or the JavaBean property using the
! * {@code @XmlTransient} annotation.
*
* <p>
* When placed on a class, it indicates that the class shouldn't be mapped
* to XML by itself. Properties on such class will be mapped to XML along
* with its derived classes, as if the class is inlined.
*
* <p><b>Usage</b></p>
! * <p> The {@code @XmlTransient} annotation can be used with the following
* program elements:
* <ul>
* <li> a JavaBean property </li>
* <li> field </li>
* <li> class </li>
* </ul>
*
! * <p>{@code @XmlTransient} is mutually exclusive with all other
* JAXB defined annotations. </p>
*
* <p>See "Package Specification" in javax.xml.bind.package javadoc for
* additional common information.</p>
*
< prev index next >