41  *   <li><b><tt>scope</tt></b> of element declaration</li>
  42  *   <li>boolean <b><tt>nil</tt></b> property. (element instance's <tt><b>xsi:nil</b></tt> attribute)</li>
  43  * </ul>
  44  *
  45  * <p>The <tt>declaredType</tt> and <tt>scope</tt> property are the
  46  * JAXB class binding for the xml type definition.
  47  * </p>
  48  *
  49  * <p><b><tt>Scope</tt></b> is either {@link GlobalScope} or the Java class representing the
  50  * complex type definition containing the schema element declaration.
  51  * </p>
  52  *
  53  * <p>There is a property constraint that if <b><tt>value</tt></b> is <tt>null</tt>,
  54  * then <tt>nil</tt> must be <tt>true</tt>. The converse is not true to enable
  55  * representing a nil element with attribute(s). If <tt>nil</tt> is true, it is possible
  56  * that <tt>value</tt> is non-null so it can hold the value of the attributes
  57  * associated with a nil element.
  58  * </p>
  59  *
  60  * @author Kohsuke Kawaguchi, Joe Fialli
  61  * @since JAXB 2.0
  62  */
  63 
  64 public class JAXBElement<T> implements Serializable {
  65 
  66     /** xml element tag name */
  67     final protected QName name;
  68 
  69     /** Java datatype binding for xml element declaration's type. */
  70     final protected Class<T> declaredType;
  71 
  72     /** Scope of xml element declaration representing this xml element instance.
  73      *  Can be one of the following values:
  74      *  - {@link GlobalScope} for global xml element declaration.
  75      *  - local element declaration has a scope set to the Java class
  76      *     representation of complex type defintion containing
  77      *     xml element declaration.
  78      */
  79     final protected Class scope;
  80 
  81     /** xml element value.

  41  *   <li><b><tt>scope</tt></b> of element declaration</li>
  42  *   <li>boolean <b><tt>nil</tt></b> property. (element instance's <tt><b>xsi:nil</b></tt> attribute)</li>
  43  * </ul>
  44  *
  45  * <p>The <tt>declaredType</tt> and <tt>scope</tt> property are the
  46  * JAXB class binding for the xml type definition.
  47  * </p>
  48  *
  49  * <p><b><tt>Scope</tt></b> is either {@link GlobalScope} or the Java class representing the
  50  * complex type definition containing the schema element declaration.
  51  * </p>
  52  *
  53  * <p>There is a property constraint that if <b><tt>value</tt></b> is <tt>null</tt>,
  54  * then <tt>nil</tt> must be <tt>true</tt>. The converse is not true to enable
  55  * representing a nil element with attribute(s). If <tt>nil</tt> is true, it is possible
  56  * that <tt>value</tt> is non-null so it can hold the value of the attributes
  57  * associated with a nil element.
  58  * </p>
  59  *
  60  * @author Kohsuke Kawaguchi, Joe Fialli
  61  * @since 1.6, JAXB 2.0
  62  */
  63 
  64 public class JAXBElement<T> implements Serializable {
  65 
  66     /** xml element tag name */
  67     final protected QName name;
  68 
  69     /** Java datatype binding for xml element declaration's type. */
  70     final protected Class<T> declaredType;
  71 
  72     /** Scope of xml element declaration representing this xml element instance.
  73      *  Can be one of the following values:
  74      *  - {@link GlobalScope} for global xml element declaration.
  75      *  - local element declaration has a scope set to the Java class
  76      *     representation of complex type defintion containing
  77      *     xml element declaration.
  78      */
  79     final protected Class scope;
  80 
  81     /** xml element value.