jaxws/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlElement.java
changeset 29839 6d5d546e953b
parent 28887 88470f768658
child 30005 b2f720a258c4
equal deleted inserted replaced
29838:fe5fd9871a13 29839:6d5d546e953b
    80  *     //Example: Code fragment
    80  *     //Example: Code fragment
    81  *     public class USPrice {
    81  *     public class USPrice {
    82  *         @XmlElement(name="itemprice")
    82  *         @XmlElement(name="itemprice")
    83  *         public java.math.BigDecimal price;
    83  *         public java.math.BigDecimal price;
    84  *     }
    84  *     }
    85  *
    85  * {@code
    86  *     <!-- Example: Local XML Schema element -->
    86  *
    87  *     <xs:complexType name="USPrice"/>
    87  *     <!-- Example: Local XML Schema element -->
    88  *       &lt;xs:sequence&gt;
    88  *     <xs:complexType name="USPrice"/>
    89  *         &lt;xs:element name="itemprice" type="xs:decimal" minOccurs="0"/&gt;
    89  *       <xs:sequence>
    90  *       &lt;/sequence&gt;
    90  *         <xs:element name="itemprice" type="xs:decimal" minOccurs="0"/>
    91  *     &lt;/xs:complexType&gt;
    91  *       </sequence>
    92  *   </pre>
    92  *     </xs:complexType>
       
    93  *   }</pre>
    93  * <p>
    94  * <p>
    94  *
    95  *
    95  * <b> Example 2: </b> Map a field to a nillable element.
    96  * <b> Example 2: </b> Map a field to a nillable element.
    96  *   <pre>
    97  *   <pre>
    97  *
    98  *
    98  *     //Example: Code fragment
    99  *     //Example: Code fragment
    99  *     public class USPrice {
   100  *     public class USPrice {
   100  *         &#64;XmlElement(nillable=true)
   101  *         &#64;XmlElement(nillable=true)
   101  *         public java.math.BigDecimal price;
   102  *         public java.math.BigDecimal price;
   102  *     }
   103  *     }
   103  *
   104  * {@code
   104  *     &lt;!-- Example: Local XML Schema element --&gt;
   105  *
   105  *     &lt;xs:complexType name="USPrice"&gt;
   106  *     <!-- Example: Local XML Schema element -->
   106  *       &lt;xs:sequence&gt;
   107  *     <xs:complexType name="USPrice">
   107  *         &lt;xs:element name="price" type="xs:decimal" nillable="true" minOccurs="0"/&gt;
   108  *       <xs:sequence>
   108  *       &lt;/sequence&gt;
   109  *         <xs:element name="price" type="xs:decimal" nillable="true" minOccurs="0"/>
   109  *     &lt;/xs:complexType&gt;
   110  *       </sequence>
   110  *   </pre>
   111  *     </xs:complexType>
       
   112  *   }</pre>
   111  * <p>
   113  * <p>
   112  * <b> Example 3: </b> Map a field to a nillable, required element.
   114  * <b> Example 3: </b> Map a field to a nillable, required element.
   113  *   <pre>
   115  *   <pre>
   114  *
   116  *
   115  *     //Example: Code fragment
   117  *     //Example: Code fragment
   116  *     public class USPrice {
   118  *     public class USPrice {
   117  *         &#64;XmlElement(nillable=true, required=true)
   119  *         &#64;XmlElement(nillable=true, required=true)
   118  *         public java.math.BigDecimal price;
   120  *         public java.math.BigDecimal price;
   119  *     }
   121  *     }
   120  *
   122  * {@code
   121  *     &lt;!-- Example: Local XML Schema element --&gt;
   123  *
   122  *     &lt;xs:complexType name="USPrice"&gt;
   124  *     <!-- Example: Local XML Schema element -->
   123  *       &lt;xs:sequence&gt;
   125  *     <xs:complexType name="USPrice">
   124  *         &lt;xs:element name="price" type="xs:decimal" nillable="true" minOccurs="1"/&gt;
   126  *       <xs:sequence>
   125  *       &lt;/sequence&gt;
   127  *         <xs:element name="price" type="xs:decimal" nillable="true" minOccurs="1"/>
   126  *     &lt;/xs:complexType&gt;
   128  *       </sequence>
   127  *   </pre>
   129  *     </xs:complexType>
       
   130  *   }</pre>
   128  *
   131  *
   129  * <p> <b>Example 4: </b>Map a JavaBean property to an XML element
   132  * <p> <b>Example 4: </b>Map a JavaBean property to an XML element
   130  * with anonymous type.</p>
   133  * with anonymous type.</p>
   131  * <p>
   134  * <p>
   132  * See Example 6 in @{@link XmlType}.
   135  * See Example 6 in @{@link XmlType}.
   177      *  and its {@link XmlSchema#elementFormDefault() elementFormDefault}
   180      *  and its {@link XmlSchema#elementFormDefault() elementFormDefault}
   178      *  is {@link XmlNsForm#QUALIFIED QUALIFIED}, then the namespace of
   181      *  is {@link XmlNsForm#QUALIFIED QUALIFIED}, then the namespace of
   179      *  the enclosing class.
   182      *  the enclosing class.
   180      *
   183      *
   181      *  <li>
   184      *  <li>
   182      *  Otherwise &#39;&#39; (which produces unqualified element in the default
   185      *  Otherwise {@literal ''} (which produces unqualified element in the default
   183      *  namespace.
   186      *  namespace.
   184      * </ol>
   187      * </ol>
   185      */
   188      */
   186     String namespace() default "##default";
   189     String namespace() default "##default";
   187 
   190