jaxws/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlAccessorType.java
changeset 32795 5a5710ee05a0
parent 25871 b80b84e87032
equal deleted inserted replaced
32712:f61a63b7d1e5 32795:5a5710ee05a0
    36 /**
    36 /**
    37  * <p> Controls whether fields or Javabean properties are serialized by default. </p>
    37  * <p> Controls whether fields or Javabean properties are serialized by default. </p>
    38  *
    38  *
    39  * <p> <b> Usage </b> </p>
    39  * <p> <b> Usage </b> </p>
    40  *
    40  *
    41  * <p> <tt>@XmlAccessorType</tt> annotation can be used with the following program elements:</p>
    41  * <p> {@code @XmlAccessorType} annotation can be used with the following program elements:</p>
    42  *
    42  *
    43  * <ul>
    43  * <ul>
    44  *   <li> package</li>
    44  *   <li> package</li>
    45  *   <li> a top level class </li>
    45  *   <li> a top level class </li>
    46  * </ul>
    46  * </ul>
    49  * additional common information.</p>
    49  * additional common information.</p>
    50  *
    50  *
    51  * <p>This annotation provides control over the default serialization
    51  * <p>This annotation provides control over the default serialization
    52  * of properties and fields in a class.
    52  * of properties and fields in a class.
    53  *
    53  *
    54  * <p>The annotation <tt> @XmlAccessorType </tt> on a package applies to
    54  * <p>The annotation {@code @XmlAccessorType} on a package applies to
    55  * all classes in the package. The following inheritance
    55  * all classes in the package. The following inheritance
    56  * semantics apply:
    56  * semantics apply:
    57  *
    57  *
    58  * <ul>
    58  * <ul>
    59  *   <li> If there is a <tt>@XmlAccessorType</tt> on a class, then it
    59  *   <li> If there is a {@code @XmlAccessorType} on a class, then it
    60  *        is used. </li>
    60  *        is used. </li>
    61  *   <li> Otherwise, if a <tt>@XmlAccessorType</tt> exists on one of
    61  *   <li> Otherwise, if a {@code @XmlAccessorType} exists on one of
    62  *        its super classes, then it is inherited.
    62  *        its super classes, then it is inherited.
    63  *   <li> Otherwise, the <tt>@XmlAccessorType </tt> on a package is
    63  *   <li> Otherwise, the {@code @XmlAccessorType} on a package is
    64  *        inherited.
    64  *        inherited.
    65  * </ul>
    65  * </ul>
    66  * <p> <b> Defaulting Rules: </b> </p>
    66  * <p> <b> Defaulting Rules: </b> </p>
    67  *
    67  *
    68  * <p>By default, if <tt>@XmlAccessorType </tt> on a package is absent,
    68  * <p>By default, if {@code @XmlAccessorType} on a package is absent,
    69  * then the following package level annotation is assumed.</p>
    69  * then the following package level annotation is assumed.</p>
    70  * <pre>
    70  * <pre>
    71  *   &#64;XmlAccessorType(XmlAccessType.PUBLIC_MEMBER)
    71  *   &#64;XmlAccessorType(XmlAccessType.PUBLIC_MEMBER)
    72  * </pre>
    72  * </pre>
    73  * <p> By default, if <tt>@XmlAccessorType</tt> on a class is absent,
    73  * <p> By default, if {@code @XmlAccessorType} on a class is absent,
    74  * and none of its super classes is annotated with
    74  * and none of its super classes is annotated with
    75  * <tt>@XmlAccessorType</tt>, then the following default on the class
    75  * {@code @XmlAccessorType}, then the following default on the class
    76  * is assumed: </p>
    76  * is assumed: </p>
    77  * <pre>
    77  * <pre>
    78  *   &#64;XmlAccessorType(XmlAccessType.PUBLIC_MEMBER)
    78  *   &#64;XmlAccessorType(XmlAccessType.PUBLIC_MEMBER)
    79  * </pre>
    79  * </pre>
    80  * <p>This annotation can be used with the following annotations:
    80  * <p>This annotation can be used with the following annotations: