jdk-sandbox: comparison jaxws/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlAnyElement.java

equal deleted inserted replaced

-:fe5fd9871a13
+:6d5d546e953b
 *
 *
 * <h2>Schema To Java example</h2>
 *
 * The following schema would produce the following Java class:
-* <pre>
+* <pre>{@code
-* &lt;xs:complexType name="foo"&gt;
+* <xs:complexType name="foo">
-*   &lt;xs:sequence&gt;
+*   <xs:sequence>
-*     &lt;xs:element name="a" type="xs:int" /&gt;
+*     <xs:element name="a" type="xs:int" />
-*     &lt;xs:element name="b" type="xs:int" /&gt;
+*     <xs:element name="b" type="xs:int" />
-*     &lt;xs:any namespace="##other" processContents="lax" minOccurs="0" maxOccurs="unbounded" /&gt;
+*     <xs:any namespace="##other" processContents="lax" minOccurs="0" maxOccurs="unbounded" />
-*   &lt;/xs:sequence&gt;
+*   </xs:sequence>
-* &lt;/xs:complexType&gt;
+* </xs:complexType>
-* </pre>
+* }</pre>
 *
 * <pre>
 * class Foo {
 *   int a;
 *   int b;
 * }
 * </pre>
 *
 * It can unmarshal instances like
 *
-* <pre>
+* <pre>{@code
-* &lt;foo xmlns:e="extra"&gt;
+* <foo xmlns:e="extra">
-*   &lt;a&gt;1&lt;/a&gt;
+*   <a>1</a>
-*   &lt;e:other /&gt;  // this will be bound to DOM, because unmarshalling is orderless
+*   <e:other />  // this will be bound to DOM, because unmarshalling is orderless
-*   &lt;b&gt;3&lt;/b&gt;
+*   <b>3</b>
-*   &lt;e:other /&gt;
+*   <e:other />
-*   &lt;c&gt;5&lt;/c&gt;     // this will be bound to DOM, because the annotation doesn't remember namespaces.
+*   <c>5</c>     // this will be bound to DOM, because the annotation doesn't remember namespaces.
-* &lt;/foo&gt;
+* </foo>
-* </pre>
+* }</pre>
 *
 *
 *
 * The following schema would produce the following Java class:
-* <pre>
+* <pre>{@code
-* &lt;xs:complexType name="bar"&gt;
+* <xs:complexType name="bar">
-*   &lt;xs:complexContent&gt;
+*   <xs:complexContent>
-*   &lt;xs:extension base="foo"&gt;
+*   <xs:extension base="foo">
-*     &lt;xs:sequence&gt;
+*     <xs:sequence>
-*       &lt;xs:element name="c" type="xs:int" /&gt;
+*       <xs:element name="c" type="xs:int" />
-*       &lt;xs:any namespace="##other" processContents="lax" minOccurs="0" maxOccurs="unbounded" /&gt;
+*       <xs:any namespace="##other" processContents="lax" minOccurs="0" maxOccurs="unbounded" />
-*     &lt;/xs:sequence&gt;
+*     </xs:sequence>
-*   &lt;/xs:extension&gt;
+*   </xs:extension>
-* &lt;/xs:complexType&gt;
+* </xs:complexType>
-* </pre>
+* }</pre>
 *
 * <pre>
 * class Bar extends Foo {
 *   int c;
 *   // Foo.getAny() also represents wildcard content for type definition bar.
 * </pre>
 *
 *
 * It can unmarshal instances like
 *
-* <pre>
+* <pre>{@code
-* &lt;bar xmlns:e="extra"&gt;
+* <bar xmlns:e="extra">
-*   &lt;a&gt;1&lt;/a&gt;
+*   <a>1</a>
-*   &lt;e:other /&gt;  // this will be bound to DOM, because unmarshalling is orderless
+*   <e:other />  // this will be bound to DOM, because unmarshalling is orderless
-*   &lt;b&gt;3&lt;/b&gt;
+*   <b>3</b>
-*   &lt;e:other /&gt;
+*   <e:other />
-*   &lt;c&gt;5&lt;/c&gt;     // this now goes to Bar.c
+*   <c>5</c>     // this now goes to Bar.c
-*   &lt;e:other /&gt;  // this will go to Foo.any
+*   <e:other />  // this will go to Foo.any
-* &lt;/bar&gt;
+* </bar>
-* </pre>
+* }</pre>
 *
 *
 *
 *
 * <h2>Using {@link XmlAnyElement} with {@link XmlElementRef}</h2>
 * The {@link XmlAnyElement} annotation can be used with {@link XmlElementRef}s to
 * designate additional elements that can participate in the content tree.
 *
 * <p>
 * The following schema would produce the following Java class:
-* <pre>
+* <pre>{@code
-* &lt;xs:complexType name="foo"&gt;
+* <xs:complexType name="foo">
-*   &lt;xs:choice maxOccurs="unbounded" minOccurs="0"&gt;
+*   <xs:choice maxOccurs="unbounded" minOccurs="0">
-*     &lt;xs:element name="a" type="xs:int" /&gt;
+*     <xs:element name="a" type="xs:int" />
-*     &lt;xs:element name="b" type="xs:int" /&gt;
+*     <xs:element name="b" type="xs:int" />
-*     &lt;xs:any namespace="##other" processContents="lax" /&gt;
+*     <xs:any namespace="##other" processContents="lax" />
-*   &lt;/xs:choice&gt;
+*   </xs:choice>
-* &lt;/xs:complexType&gt;
+* </xs:complexType>
-* </pre>
+* }</pre>
 *
 * <pre>
 * class Foo {
 *   &#64;{@link XmlAnyElement}(lax="true")
 *   &#64;{@link XmlElementRefs}({
 * </pre>
 *
 * It can unmarshal instances like
 *
 * <pre>
-* &lt;foo xmlns:e="extra"&gt;
+*{@code <foo xmlns:e="extra">}
-*   &lt;a&gt;1&lt;/a&gt;     // this will unmarshal to a {@link JAXBElement} instance whose value is 1.
+*{@code   <a>1</a>}     // this will unmarshal to a {@link JAXBElement} instance whose value is 1.
-*   &lt;e:other /&gt;  // this will unmarshal to a DOM {@link Element}.
+*{@code   <e:other />}  // this will unmarshal to a DOM {@link Element}.
-*   &lt;b&gt;3&lt;/b&gt;     // this will unmarshal to a {@link JAXBElement} instance whose value is 1.
+*{@code   <b>3</b>}     // this will unmarshal to a {@link JAXBElement} instance whose value is 1.
-* &lt;/foo&gt;
+*{@code </foo>}
 * </pre>
 *
 *
 *
 *
 *   &#64;XmlAnyElement(lax=true)
 *   public {@link Object}[] others;
 * }
 * </pre>
 * then the following document will unmarshal like this:
-* <pre>
+* <pre>{@code
-* &lt;foo&gt;
+* <foo>
-*   &lt;unknown /&gt;
+*   <unknown />
-*   &lt;foo /&gt;
+*   <foo />
-* &lt;/foo&gt;
+* </foo>
 *
 * Foo foo = unmarshal();
 * // 1 for 'unknown', another for 'foo'
 * assert foo.others.length==2;
 * // 'unknown' unmarshals to a DOM element
 * assert foo.others[0] instanceof Element;
 * // because of lax=true, the 'foo' element eagerly
 * // unmarshals to a Foo object.
 * assert foo.others[1] instanceof Foo;
-* </pre>
+* }</pre>
 *
 * @author Kohsuke Kawaguchi
 * @since 1.6, JAXB 2.0
 */
 @Retention(RUNTIME)

changeset 29839	6d5d546e953b
parent 28887	88470f768658