You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@poi.apache.org by ki...@apache.org on 2021/12/31 00:01:17 UTC

svn commit: r1896561 [6/8] - in /xmlbeans: site/src/documentation/content/xdocs/ trunk/ trunk/gradle/ trunk/samples/ trunk/samples/AbstractTypes/ trunk/samples/Any/ trunk/samples/Any/src/org/apache/xmlbeans/samples/any/ trunk/samples/DateTime/ trunk/sa...

Modified: xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/soap/SOAPFactory.java
URL: http://svn.apache.org/viewvc/xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/soap/SOAPFactory.java?rev=1896561&r1=1896560&r2=1896561&view=diff
==============================================================================
--- xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/soap/SOAPFactory.java (original)
+++ xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/soap/SOAPFactory.java Fri Dec 31 00:01:16 2021
@@ -16,18 +16,18 @@
 package org.apache.xmlbeans.impl.soap;
 
 /**
- * <code>SOAPFactory</code> is a factory for creating various objects
+ * {@code SOAPFactory} is a factory for creating various objects
  * that exist in the SOAP XML tree.
  *
- * <code>SOAPFactory</code> can be
+ * {@code SOAPFactory} can be
  * used to create XML fragments that will eventually end up in the
  * SOAP part. These fragments can be inserted as children of the
- * <code>SOAPHeaderElement</code> or <code>SOAPBodyElement</code> or
- * <code>SOAPEnvelope</code>.
+ * {@code SOAPHeaderElement} or {@code SOAPBodyElement} or
+ * {@code SOAPEnvelope}.
  *
- * <code>SOAPFactory</code> also has methods to create
- * <code>javax.xml.soap.Detail</code> objects as well as
- * <code>java.xml.soap.Name</code> objects.
+ * {@code SOAPFactory} also has methods to create
+ * {@code javax.xml.soap.Detail} objects as well as
+ * {@code java.xml.soap.Name} objects.
  *
  */
 public abstract class SOAPFactory {
@@ -35,73 +35,73 @@ public abstract class SOAPFactory {
     public SOAPFactory() {}
 
     /**
-     * Create a <code>SOAPElement</code> object initialized with the
-     * given <code>Name</code> object.
+     * Create a {@code SOAPElement} object initialized with the
+     * given {@code Name} object.
      *
-     * @param name a <code>Name</code> object with the XML name for
+     * @param name a {@code Name} object with the XML name for
      *        the new element
-     * @return  the new <code>SOAPElement</code> object that was
+     * @return  the new {@code SOAPElement} object that was
      *    created
      * @throws SOAPException if there is an error in creating the
-     *       <code>SOAPElement</code> object
+     *       {@code SOAPElement} object
      */
     public abstract SOAPElement createElement(Name name) throws SOAPException;
 
     /**
-     * Create a <code>SOAPElement</code> object initialized with the
+     * Create a {@code SOAPElement} object initialized with the
      * given local name.
      *
-     * @param localName a <code>String</code> giving the local name for
+     * @param localName a {@code String} giving the local name for
      *       the new element
-     * @return the new <code>SOAPElement</code> object that was
+     * @return the new {@code SOAPElement} object that was
      *    created
      * @throws SOAPException if there is an error in creating the
-     *       <code>SOAPElement</code> object
+     *       {@code SOAPElement} object
      */
     public abstract SOAPElement createElement(String localName) throws SOAPException;
 
     /**
-     * Create a new <code>SOAPElement</code> object with the given
+     * Create a new {@code SOAPElement} object with the given
      * local name, prefix and uri.
      *
-     * @param localName a <code>String</code> giving the local name
+     * @param localName a {@code String} giving the local name
      *            for the new element
-     * @param prefix the prefix for this <code>SOAPElement</code>
-     * @param uri a <code>String</code> giving the URI of the
+     * @param prefix the prefix for this {@code SOAPElement}
+     * @param uri a {@code String} giving the URI of the
      *      namespace to which the new element belongs
-     * @return the new <code>SOAPElement</code> object that was
+     * @return the new {@code SOAPElement} object that was
      *    created
      * @throws SOAPException if there is an error in creating the
-     *      <code>SOAPElement</code> object
+     *      {@code SOAPElement} object
      */
     public abstract SOAPElement createElement(String localName, String prefix, String uri)
         throws SOAPException;
 
     /**
-     * Creates a new <code>Detail</code> object which serves as a container
-     * for <code>DetailEntry</code> objects.
+     * Creates a new {@code Detail} object which serves as a container
+     * for {@code DetailEntry} objects.
      * <p>
-     * This factory method creates <code>Detail</code> objects for use in
-     * situations where it is not practical to use the <code>SOAPFault</code>
+     * This factory method creates {@code Detail} objects for use in
+     * situations where it is not practical to use the {@code SOAPFault}
      * abstraction.
      *
-     * @return a <code>Detail</code> object
+     * @return a {@code Detail} object
      * @throws SOAPException if there is a SOAP error
      */
     public abstract Detail createDetail() throws SOAPException;
 
     /**
-     * Creates a new <code>Name</code> object initialized with the
+     * Creates a new {@code Name} object initialized with the
      * given local name, namespace prefix, and namespace URI.
      * <p>
-     * This factory method creates <code>Name</code> objects for use in
-     * situations where it is not practical to use the <code>SOAPEnvelope</code>
+     * This factory method creates {@code Name} objects for use in
+     * situations where it is not practical to use the {@code SOAPEnvelope}
      * abstraction.
      *
-     * @param localName a <code>String</code> giving the local name
-     * @param prefix a <code>String</code> giving the prefix of the namespace
-     * @param uri a <code>String</code> giving the URI of the namespace
-     * @return a <code>Name</code> object initialized with the given
+     * @param localName a {@code String} giving the local name
+     * @param prefix a {@code String} giving the prefix of the namespace
+     * @param uri a {@code String} giving the URI of the namespace
+     * @return a {@code Name} object initialized with the given
      *   local name, namespace prefix, and namespace URI
      * @throws SOAPException if there is a SOAP error
      */
@@ -109,26 +109,26 @@ public abstract class SOAPFactory {
         throws SOAPException;
 
     /**
-     * Creates a new <code>Name</code> object initialized with the
+     * Creates a new {@code Name} object initialized with the
      * given local name.
      * <p>
-     * This factory method creates <code>Name</code> objects for use in
-     * situations where it is not practical to use the <code>SOAPEnvelope</code>
+     * This factory method creates {@code Name} objects for use in
+     * situations where it is not practical to use the {@code SOAPEnvelope}
      * abstraction.
      *
-     * @param localName a <code>String</code> giving the local name
-     * @return a <code>Name</code> object initialized with the given
+     * @param localName a {@code String} giving the local name
+     * @return a {@code Name} object initialized with the given
      *    local name
      * @throws SOAPException if there is a SOAP error
      */
     public abstract Name createName(String localName) throws SOAPException;
 
     /**
-     * Creates a new instance of <code>SOAPFactory</code>.
+     * Creates a new instance of {@code SOAPFactory}.
      *
-     * @return a new instance of a <code>SOAPFactory</code>
+     * @return a new instance of a {@code SOAPFactory}
      * @throws SOAPException if there was an error creating the
-     *       default <code>SOAPFactory</code>
+     *       default {@code SOAPFactory}
      */
     public static SOAPFactory newInstance() throws SOAPException {
 

Modified: xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/soap/SOAPFault.java
URL: http://svn.apache.org/viewvc/xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/soap/SOAPFault.java?rev=1896561&r1=1896560&r2=1896561&view=diff
==============================================================================
--- xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/soap/SOAPFault.java (original)
+++ xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/soap/SOAPFault.java Fri Dec 31 00:01:16 2021
@@ -18,17 +18,17 @@ package org.apache.xmlbeans.impl.soap;
 import java.util.Locale;
 
 /**
- * An element in the <CODE>SOAPBody</CODE> object that contains
+ * An element in the {@code SOAPBody} object that contains
  *   error and/or status information. This information may relate to
- *   errors in the <CODE>SOAPMessage</CODE> object or to problems
+ *   errors in the {@code SOAPMessage} object or to problems
  *   that are not related to the content in the message itself.
  *   Problems not related to the message itself are generally errors
  *   in processing, such as the inability to communicate with an
  *   upstream server.
  *   <P>
- *   The <CODE>SOAPFault</CODE> interface provides methods for
- *   retrieving the information contained in a <CODE>
- *   SOAPFault</CODE> object and for setting the fault code, the
+ *   The {@code SOAPFault} interface provides methods for
+ *   retrieving the information contained in a {@code
+ *   SOAPFault} object and for setting the fault code, the
  *   fault actor, and a string describing the fault. A fault code is
  *   one of the codes defined in the SOAP 1.1 specification that
  *   describe the fault. An actor is an intermediate recipient to
@@ -40,164 +40,165 @@ import java.util.Locale;
 public interface SOAPFault extends SOAPBodyElement {
 
     /**
-     * Sets this <CODE>SOAPFault</CODE> object with the given
+     * Sets this {@code SOAPFault} object with the given
      *   fault code.
      *
      *   <P>Fault codes, which given information about the fault,
      *   are defined in the SOAP 1.1 specification.</P>
-     * @param   faultCode a <CODE>String</CODE> giving
+     * @param   faultCode a {@code String} giving
      *     the fault code to be set; must be one of the fault codes
      *     defined in the SOAP 1.1 specification
      * @throws  SOAPException if there was an error in
-     *     adding the <CODE>faultCode</CODE> to the underlying XML
+     *     adding the {@code faultCode} to the underlying XML
      *     tree.
      * @see #getFaultCode() getFaultCode()
      */
-    public abstract void setFaultCode(String faultCode) throws SOAPException;
+    void setFaultCode(String faultCode) throws SOAPException;
 
     /**
-     * Gets the fault code for this <CODE>SOAPFault</CODE>
+     * Gets the fault code for this {@code SOAPFault}
      * object.
-     * @return a <CODE>String</CODE> with the fault code
+     * @return a {@code String} with the fault code
      * @see #setFaultCode(java.lang.String) setFaultCode(java.lang.String)
      */
-    public abstract String getFaultCode();
+    String getFaultCode();
 
     /**
-     *  Sets this <CODE>SOAPFault</CODE> object with the given
+     *  Sets this {@code SOAPFault} object with the given
      *   fault actor.
      *
      *   <P>The fault actor is the recipient in the message path who
      *   caused the fault to happen.</P>
-     * @param   faultActor a <CODE>String</CODE>
-     *     identifying the actor that caused this <CODE>
-     *     SOAPFault</CODE> object
+     * @param   faultActor a {@code String}
+     *     identifying the actor that caused this {@code
+     *     SOAPFault} object
      * @throws  SOAPException  if there was an error in
-     *     adding the <CODE>faultActor</CODE> to the underlying XML
+     *     adding the {@code faultActor} to the underlying XML
      *     tree.
      * @see #getFaultActor() getFaultActor()
      */
-    public abstract void setFaultActor(String faultActor) throws SOAPException;
+    void setFaultActor(String faultActor) throws SOAPException;
 
     /**
-     * Gets the fault actor for this <CODE>SOAPFault</CODE>
+     * Gets the fault actor for this {@code SOAPFault}
      * object.
-     * @return  a <CODE>String</CODE> giving the actor in the message
-     *     path that caused this <CODE>SOAPFault</CODE> object
+     * @return  a {@code String} giving the actor in the message
+     *     path that caused this {@code SOAPFault} object
      * @see #setFaultActor(java.lang.String) setFaultActor(java.lang.String)
      */
-    public abstract String getFaultActor();
+    String getFaultActor();
 
     /**
-     * Sets the fault string for this <CODE>SOAPFault</CODE>
+     * Sets the fault string for this {@code SOAPFault}
      * object to the given string.
      *
-     * @param faultString a <CODE>String</CODE>
+     * @param faultString a {@code String}
      *     giving an explanation of the fault
      * @throws  SOAPException  if there was an error in
-     *     adding the <CODE>faultString</CODE> to the underlying XML
+     *     adding the {@code faultString} to the underlying XML
      *     tree.
      * @see #getFaultString() getFaultString()
      */
-    public abstract void setFaultString(String faultString)
+    void setFaultString(String faultString)
         throws SOAPException;
 
     /**
-     * Gets the fault string for this <CODE>SOAPFault</CODE>
+     * Gets the fault string for this {@code SOAPFault}
      * object.
-     * @return a <CODE>String</CODE> giving an explanation of the
+     * @return a {@code String} giving an explanation of the
      *     fault
      */
-    public abstract String getFaultString();
+    String getFaultString();
 
     /**
-     * Returns the detail element for this <CODE>SOAPFault</CODE>
+     * Returns the detail element for this {@code SOAPFault}
      *   object.
      *
-     *   <P>A <CODE>Detail</CODE> object carries
-     *   application-specific error information related to <CODE>
-     *   SOAPBodyElement</CODE> objects.</P>
-     * @return  a <CODE>Detail</CODE> object with
+     *   <P>A {@code Detail} object carries
+     *   application-specific error information related to {@code
+     *   SOAPBodyElement} objects.</P>
+     * @return  a {@code Detail} object with
      *     application-specific error information
      */
-    public abstract Detail getDetail();
+    Detail getDetail();
 
     /**
-     * Creates a <CODE>Detail</CODE> object and sets it as the
-     *   <CODE>Detail</CODE> object for this <CODE>SOAPFault</CODE>
+     * Creates a {@code Detail} object and sets it as the
+     *   {@code Detail} object for this {@code SOAPFault}
      *   object.
      *
      *   <P>It is illegal to add a detail when the fault already
      *   contains a detail. Therefore, this method should be called
      *   only after the existing detail has been removed.</P>
-     * @return the new <CODE>Detail</CODE> object
+     * @return the new {@code Detail} object
      * @throws  SOAPException  if this
-     *     <CODE>SOAPFault</CODE> object already contains a valid
-     *     <CODE>Detail</CODE> object
+     *     {@code SOAPFault} object already contains a valid
+     *     {@code Detail} object
      */
-    public abstract Detail addDetail() throws SOAPException;
+    Detail addDetail() throws SOAPException;
 
     /**
-     * Sets this <code>SOAPFault</code> object with the given fault code.
+     * Sets this {@code SOAPFault} object with the given fault code.
      *
      * Fault codes, which give information about the fault, are defined in the
      * SOAP 1.1 specification. A fault code is mandatory and must be of type
-     * <code>QName</code>. This method provides a convenient way to set a fault
+     * {@code QName}. This method provides a convenient way to set a fault
      * code. For example,
      *
-     * <pre>
-     SOAPEnvelope se = ...;
-     // Create a qualified name in the SOAP namespace with a localName
-     // of "Client".  Note that prefix parameter is optional and is null
-     // here which causes the implementation to use an appropriate prefix.
-     Name qname = se.createName("Client", null,
-     SOAPConstants.URI_NS_SOAP_ENVELOPE);
-     SOAPFault fault = ...;
-     fault.setFaultCode(qname);
+     * <pre>{@code
+     * SOAPEnvelope se = ...;
+     * // Create a qualified name in the SOAP namespace with a localName
+     * // of "Client".  Note that prefix parameter is optional and is null
+     * // here which causes the implementation to use an appropriate prefix.
+     * Name qname = se.createName("Client", null,
+     * SOAPConstants.URI_NS_SOAP_ENVELOPE);
+     * SOAPFault fault = ...;
+     * fault.setFaultCode(qname);
+     * }</pre>
      *
      * It is preferable to use this method over setFaultCode(String).
      *
-     * @param name a <code>Name</code> object giving the fault code to be set.
+     * @param name a {@code Name} object giving the fault code to be set.
      *              It must be namespace qualified.
      * @throws SOAPException if there was an error in adding the
-     *              <code>faultcode</code> element to the underlying XML tree
+     *              {@code faultcode} element to the underlying XML tree
      */
-    public abstract void setFaultCode(Name name) throws SOAPException;
+    void setFaultCode(Name name) throws SOAPException;
 
     /**
-     * Gets the mandatory SOAP 1.1 fault code for this <code>SOAPFault</code>
-     * object as a SAAJ <code>Name</code> object. The SOAP 1.1 specification
+     * Gets the mandatory SOAP 1.1 fault code for this {@code SOAPFault}
+     * object as a SAAJ {@code Name} object. The SOAP 1.1 specification
      * requires the value of the "faultcode" element to be of type QName. This
      * method returns the content of the element as a QName in the form of a
-     * SAAJ <code>Name</code> object. This method should be used instead of the
-     * <code>getFaultCode()</code> method since it allows applications to easily
+     * SAAJ {@code Name} object. This method should be used instead of the
+     * {@code getFaultCode()} method since it allows applications to easily
      * access the namespace name without additional parsing.
      * <p>
      * In the future, a QName object version of this method may also be added.
-     * @return a <code>Name</code> representing the faultcode
+     * @return a {@code Name} representing the faultcode
      */
-    public abstract Name getFaultCodeAsName();
+    Name getFaultCodeAsName();
 
     /**
-     * Sets the fault string for this <code>SOAPFault</code> object to the given
+     * Sets the fault string for this {@code SOAPFault} object to the given
      * string and localized to the given locale.
      *
-     * @param faultString       a <code>String</code> giving an explanation of
+     * @param faultString       a {@code String} giving an explanation of
      *              the fault
-     * @param locale            a <code>Locale</code> object indicating the
-     *              native language of the <code>faultString</code>
+     * @param locale            a {@code Locale} object indicating the
+     *              native language of the {@code faultString}
      * @throws SOAPException    if there was an error in adding the
-     *              <code>faultString</code> to the underlying XML tree
+     *              {@code faultString} to the underlying XML tree
      */
-    public abstract void setFaultString(String faultString, Locale locale) throws SOAPException;
+    void setFaultString(String faultString, Locale locale) throws SOAPException;
 
     /**
-     * Returns the optional detail element for this <code>SOAPFault</code>
+     * Returns the optional detail element for this {@code SOAPFault}
      * object.
      *
-     * @return a <code>Locale</code> object indicating the native language of
-     *              the fault string or <code>null</code> if no locale was
+     * @return a {@code Locale} object indicating the native language of
+     *              the fault string or {@code null} if no locale was
      *              specified
      */
-    public abstract Locale getFaultStringLocale();
+    Locale getFaultStringLocale();
 }

Modified: xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/soap/SOAPFaultElement.java
URL: http://svn.apache.org/viewvc/xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/soap/SOAPFaultElement.java?rev=1896561&r1=1896560&r2=1896561&view=diff
==============================================================================
--- xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/soap/SOAPFaultElement.java (original)
+++ xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/soap/SOAPFaultElement.java Fri Dec 31 00:01:16 2021
@@ -17,10 +17,10 @@ package org.apache.xmlbeans.impl.soap;
 
 /**
  * A representation of the contents in
- * a <code>SOAPFault</code> object.  The <code>Detail</code> interface
- * is a <code>SOAPFaultElement</code> object that has been defined.
+ * a {@code SOAPFault} object.  The {@code Detail} interface
+ * is a {@code SOAPFaultElement} object that has been defined.
  * <p>
- * Content is added to a <code>SOAPFaultElement</code> using the
- * <code>SOAPElement</code> method <code>addTextNode</code>.
+ * Content is added to a {@code SOAPFaultElement} using the
+ * {@code SOAPElement} method {@code addTextNode}.
  */
 public interface SOAPFaultElement extends SOAPElement {}

Modified: xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/soap/SOAPHeader.java
URL: http://svn.apache.org/viewvc/xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/soap/SOAPHeader.java?rev=1896561&r1=1896560&r2=1896561&view=diff
==============================================================================
--- xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/soap/SOAPHeader.java (original)
+++ xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/soap/SOAPHeader.java Fri Dec 31 00:01:16 2021
@@ -23,19 +23,19 @@ import java.util.Iterator;
  *   application-specific content is processed by the message
  *   provider. For example, transaction semantics, authentication
  *   information, and so on, can be specified as the content of a
- *   <CODE>SOAPHeader</CODE> object.</P>
+ *   {@code SOAPHeader} object.</P>
  *
- *   <P>A <CODE>SOAPEnvelope</CODE> object contains an empty <CODE>
- *   SOAPHeader</CODE> object by default. If the <CODE>
- *   SOAPHeader</CODE> object, which is optional, is not needed, it
+ *   <P>A {@code SOAPEnvelope} object contains an empty {@code
+ *   SOAPHeader} object by default. If the {@code
+ *   SOAPHeader} object, which is optional, is not needed, it
  *   can be retrieved and deleted with the following line of code.
- *   The variable <I>se</I> is a <CODE>SOAPEnvelope</CODE>
+ *   The variable <I>se</I> is a {@code SOAPEnvelope}
  *   object.</P>
  * <PRE>
  *     se.getHeader().detachNode();
  * </PRE>
- *   A <CODE>SOAPHeader</CODE> object is created with the <CODE>
- *   SOAPEnvelope</CODE> method <CODE>addHeader</CODE>. This method,
+ *   A {@code SOAPHeader} object is created with the {@code
+ *   SOAPEnvelope} method {@code addHeader}. This method,
  *   which creates a new header and adds it to the envelope, may be
  *   called only after the existing header has been removed.
  * <PRE>
@@ -43,14 +43,14 @@ import java.util.Iterator;
  *     SOAPHeader sh = se.addHeader();
  * </PRE>
  *
- *   <P>A <CODE>SOAPHeader</CODE> object can have only <CODE>
- *   SOAPHeaderElement</CODE> objects as its immediate children. The
- *   method <CODE>addHeaderElement</CODE> creates a new <CODE>
- *   HeaderElement</CODE> object and adds it to the <CODE>
- *   SOAPHeader</CODE> object. In the following line of code, the
- *   argument to the method <CODE>addHeaderElement</CODE> is a
- *   <CODE>Name</CODE> object that is the name for the new <CODE>
- *   HeaderElement</CODE> object.</P>
+ *   <P>A {@code SOAPHeader} object can have only {@code
+ *   SOAPHeaderElement} objects as its immediate children. The
+ *   method {@code addHeaderElement} creates a new {@code
+ *   HeaderElement} object and adds it to the {@code
+ *   SOAPHeader} object. In the following line of code, the
+ *   argument to the method {@code addHeaderElement} is a
+ *   {@code Name} object that is the name for the new {@code
+ *   HeaderElement} object.</P>
  * <PRE>
  *     SOAPHeaderElement shElement = sh.addHeaderElement(name);
  * </PRE>
@@ -59,91 +59,91 @@ import java.util.Iterator;
 public interface SOAPHeader extends SOAPElement {
 
     /**
-     * Creates a new <CODE>SOAPHeaderElement</CODE> object
+     * Creates a new {@code SOAPHeaderElement} object
      * initialized with the specified name and adds it to this
-     * <CODE>SOAPHeader</CODE> object.
-     * @param   name a <CODE>Name</CODE> object with
-     *     the name of the new <CODE>SOAPHeaderElement</CODE>
+     * {@code SOAPHeader} object.
+     * @param   name a {@code Name} object with
+     *     the name of the new {@code SOAPHeaderElement}
      *     object
-     * @return the new <CODE>SOAPHeaderElement</CODE> object that
-     *     was inserted into this <CODE>SOAPHeader</CODE>
+     * @return the new {@code SOAPHeaderElement} object that
+     *     was inserted into this {@code SOAPHeader}
      *     object
      * @throws  SOAPException if a SOAP error occurs
      */
-    public abstract SOAPHeaderElement addHeaderElement(Name name)
+    SOAPHeaderElement addHeaderElement(Name name)
         throws SOAPException;
 
     /**
-     * Returns a list of all the <CODE>SOAPHeaderElement</CODE>
-     * objects in this <CODE>SOAPHeader</CODE> object that have the
+     * Returns a list of all the {@code SOAPHeaderElement}
+     * objects in this {@code SOAPHeader} object that have the
      * the specified actor. An actor is a global attribute that
      * indicates the intermediate parties to whom the message should
      * be sent. An actor receives the message and then sends it to
      * the next actor. The default actor is the ultimate intended
      * recipient for the message, so if no actor attribute is
-     * included in a <CODE>SOAPHeader</CODE> object, the message is
+     * included in a {@code SOAPHeader} object, the message is
      * sent to its ultimate destination.
-     * @param   actor  a <CODE>String</CODE> giving the
+     * @param   actor  a {@code String} giving the
      *     URI of the actor for which to search
-     * @return an <CODE>Iterator</CODE> object over all the <CODE>
-     *     SOAPHeaderElement</CODE> objects that contain the
+     * @return an {@code Iterator} object over all the {@code
+     *     SOAPHeaderElement} objects that contain the
      *     specified actor
      * @see #extractHeaderElements(java.lang.String) extractHeaderElements(java.lang.String)
      */
-    public abstract Iterator examineHeaderElements(String actor);
+    Iterator examineHeaderElements(String actor);
 
     /**
-     * Returns a list of all the <CODE>SOAPHeaderElement</CODE>
-     *   objects in this <CODE>SOAPHeader</CODE> object that have
-     *   the the specified actor and detaches them from this <CODE>
-     *   SOAPHeader</CODE> object.
+     * Returns a list of all the {@code SOAPHeaderElement}
+     *   objects in this {@code SOAPHeader} object that have
+     *   the the specified actor and detaches them from this {@code
+     *   SOAPHeader} object.
      *
      *   <P>This method allows an actor to process only the parts of
-     *   the <CODE>SOAPHeader</CODE> object that apply to it and to
+     *   the {@code SOAPHeader} object that apply to it and to
      *   remove them before passing the message on to the next
      *   actor.
-     * @param   actor  a <CODE>String</CODE> giving the
+     * @param   actor  a {@code String} giving the
      *     URI of the actor for which to search
-     * @return an <CODE>Iterator</CODE> object over all the <CODE>
-     *     SOAPHeaderElement</CODE> objects that contain the
+     * @return an {@code Iterator} object over all the {@code
+     *     SOAPHeaderElement} objects that contain the
      *     specified actor
      * @see #examineHeaderElements(java.lang.String) examineHeaderElements(java.lang.String)
      */
-    public abstract Iterator extractHeaderElements(String actor);
+    Iterator extractHeaderElements(String actor);
 
     /**
-     * Returns an <code>Iterator</code> over all the
-     * <code>SOAPHeaderElement</code> objects in this <code>SOAPHeader</code>
+     * Returns an {@code Iterator} over all the
+     * {@code SOAPHeaderElement} objects in this {@code SOAPHeader}
      * object that have the specified actor and that have a MustUnderstand
-     * attribute whose value is equivalent to <code>true</code>.
+     * attribute whose value is equivalent to {@code true}.
      *
-     * @param actor a <code>String</code> giving the URI of the actor for which
+     * @param actor a {@code String} giving the URI of the actor for which
      *              to search
-     * @return an <code>Iterator</code> object over all the
-     *              <code>SOAPHeaderElement</code> objects that contain the
+     * @return an {@code Iterator} object over all the
+     *              {@code SOAPHeaderElement} objects that contain the
      *              specified actor and are marked as MustUnderstand
      */
-    public abstract Iterator examineMustUnderstandHeaderElements(String actor);
+    Iterator examineMustUnderstandHeaderElements(String actor);
 
     /**
-     * Returns an <code>Iterator</code> over all the
-     * <code>SOAPHeaderElement</code> objects in this <code>SOAPHeader</code>
+     * Returns an {@code Iterator} over all the
+     * {@code SOAPHeaderElement} objects in this {@code SOAPHeader}
      * object.
      *
-     * @return an <code>Iterator</code> object over all the
-     *              <code>SOAPHeaderElement</code> objects contained by this
-     *              <code>SOAPHeader</code>
+     * @return an {@code Iterator} object over all the
+     *              {@code SOAPHeaderElement} objects contained by this
+     *              {@code SOAPHeader}
      */
-    public abstract Iterator examineAllHeaderElements();
+    Iterator examineAllHeaderElements();
 
     /**
-     * Returns an <code>Iterator</code> over all the
-     * <code>SOAPHeaderElement</code> objects in this <code>SOAPHeader </code>
-     * object and detaches them from this <code>SOAPHeader</code> object.
+     * Returns an {@code Iterator} over all the
+     * {@code SOAPHeaderElement} objects in this {@code SOAPHeader }
+     * object and detaches them from this {@code SOAPHeader} object.
      *
-     * @return an <code>Iterator</code> object over all the
-     *              <code>SOAPHeaderElement</code> objects contained by this
-     *              <code>SOAPHeader</code>
+     * @return an {@code Iterator} object over all the
+     *              {@code SOAPHeaderElement} objects contained by this
+     *              {@code SOAPHeader}
      */
-    public abstract Iterator extractAllHeaderElements();
+    Iterator extractAllHeaderElements();
 }

Modified: xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/soap/SOAPHeaderElement.java
URL: http://svn.apache.org/viewvc/xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/soap/SOAPHeaderElement.java?rev=1896561&r1=1896560&r2=1896561&view=diff
==============================================================================
--- xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/soap/SOAPHeaderElement.java (original)
+++ xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/soap/SOAPHeaderElement.java Fri Dec 31 00:01:16 2021
@@ -17,61 +17,61 @@ package org.apache.xmlbeans.impl.soap;
 
 /**
  *     <P>An object representing the contents in the SOAP header part
- *   of the SOAP envelope. The immediate children of a <CODE>
- *   SOAPHeader</CODE> object can be represented only as <CODE>
- *   SOAPHeaderElement</CODE> objects.</P>
+ *   of the SOAP envelope. The immediate children of a {@code
+ *   SOAPHeader} object can be represented only as {@code
+ *   SOAPHeaderElement} objects.</P>
  *
- *   <P>A <CODE>SOAPHeaderElement</CODE> object can have other
- *   <CODE>SOAPElement</CODE> objects as its children.</P>
+ *   <P>A {@code SOAPHeaderElement} object can have other
+ *   {@code SOAPElement} objects as its children.</P>
  */
 public interface SOAPHeaderElement extends SOAPElement {
 
     /**
-     * Sets the actor associated with this <CODE>
-     * SOAPHeaderElement</CODE> object to the specified actor. The
-     * default value of an actor is: <CODE>
-     * SOAPConstants.URI_SOAP_ACTOR_NEXT</CODE>
-     * @param  actorURI  a <CODE>String</CODE> giving
+     * Sets the actor associated with this {@code
+     * SOAPHeaderElement} object to the specified actor. The
+     * default value of an actor is: {@code
+     * SOAPConstants.URI_SOAP_ACTOR_NEXT}
+     * @param  actorURI  a {@code String} giving
      *     the URI of the actor to set
      * @see #getActor() getActor()
      * @throws java.lang.IllegalArgumentException if
      *     there is a problem in setting the actor.
      */
-    public abstract void setActor(String actorURI);
+    void setActor(String actorURI);
 
     /**
-     * Returns the uri of the actor associated with this <CODE>
-     * SOAPHeaderElement</CODE> object.
-     * @return  a <CODE>String</CODE> giving the URI of the
+     * Returns the uri of the actor associated with this {@code
+     * SOAPHeaderElement} object.
+     * @return  a {@code String} giving the URI of the
      *     actor
      * @see #setActor(java.lang.String) setActor(java.lang.String)
      */
-    public abstract String getActor();
+    String getActor();
 
     /**
-     * Sets the mustUnderstand attribute for this <CODE>
-     *   SOAPHeaderElement</CODE> object to be on or off.
+     * Sets the mustUnderstand attribute for this {@code
+     *   SOAPHeaderElement} object to be on or off.
      *
      *   <P>If the mustUnderstand attribute is on, the actor who
-     *   receives the <CODE>SOAPHeaderElement</CODE> must process it
-     *   correctly. This ensures, for example, that if the <CODE>
-     *   SOAPHeaderElement</CODE> object modifies the message, that
+     *   receives the {@code SOAPHeaderElement} must process it
+     *   correctly. This ensures, for example, that if the {@code
+     *   SOAPHeaderElement} object modifies the message, that
      *   the message is being modified correctly.</P>
-     * @param  mustUnderstand  <CODE>true</CODE> to
-     *     set the mustUnderstand attribute on; <CODE>false</CODE>
+     * @param  mustUnderstand  {@code true} to
+     *     set the mustUnderstand attribute on; {@code false}
      *     to turn if off
      * @throws java.lang.IllegalArgumentException if
      *     there is a problem in setting the actor.
      * @see #getMustUnderstand() getMustUnderstand()
      */
-    public abstract void setMustUnderstand(boolean mustUnderstand);
+    void setMustUnderstand(boolean mustUnderstand);
 
     /**
      * Returns whether the mustUnderstand attribute for this
-     * <CODE>SOAPHeaderElement</CODE> object is turned on.
-     * @return  <CODE>true</CODE> if the mustUnderstand attribute of
-     *     this <CODE>SOAPHeaderElement</CODE> object is turned on;
-     *     <CODE>false</CODE> otherwise
+     * {@code SOAPHeaderElement} object is turned on.
+     * @return  {@code true} if the mustUnderstand attribute of
+     *     this {@code SOAPHeaderElement} object is turned on;
+     *     {@code false} otherwise
      */
-    public abstract boolean getMustUnderstand();
+    boolean getMustUnderstand();
 }

Modified: xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/soap/SOAPMessage.java
URL: http://svn.apache.org/viewvc/xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/soap/SOAPMessage.java?rev=1896561&r1=1896560&r2=1896561&view=diff
==============================================================================
--- xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/soap/SOAPMessage.java (original)
+++ xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/soap/SOAPMessage.java Fri Dec 31 00:01:16 2021
@@ -26,32 +26,32 @@ import java.util.Iterator;
  * "wire", a SOAP message is an XML document or a MIME message
  * whose first body part is an XML/SOAP document.</P>
  *
- * <P>A <CODE>SOAPMessage</CODE> object consists of a SOAP part
+ * <P>A {@code SOAPMessage} object consists of a SOAP part
  * and optionally one or more attachment parts. The SOAP part for
- * a <CODE>SOAPMessage</CODE> object is a <CODE>SOAPPart</CODE>
+ * a {@code SOAPMessage} object is a {@code SOAPPart}
  * object, which contains information used for message routing and
  * identification, and which can contain application-specific
  * content. All data in the SOAP Part of a message must be in XML
  * format.</P>
  *
- * <P>A new <CODE>SOAPMessage</CODE> object contains the following
+ * <P>A new {@code SOAPMessage} object contains the following
  * by default:</P>
  *
  * <UL>
- *  <LI>A <CODE>SOAPPart</CODE> object</LI>
+ *  <LI>A {@code SOAPPart} object</LI>
  *
- *  <LI>A <CODE>SOAPEnvelope</CODE> object</LI>
+ *  <LI>A {@code SOAPEnvelope} object</LI>
  *
- *  <LI>A <CODE>SOAPBody</CODE> object</LI>
+ *  <LI>A {@code SOAPBody} object</LI>
  *
- *  <LI>A <CODE>SOAPHeader</CODE> object</LI>
+ *  <LI>A {@code SOAPHeader} object</LI>
  * </UL>
  * The SOAP part of a message can be retrieved by calling the
- * method <CODE>SOAPMessage.getSOAPPart()</CODE>. The <CODE>
- * SOAPEnvelope</CODE> object is retrieved from the <CODE>
- * SOAPPart</CODE> object, and the <CODE>SOAPEnvelope</CODE>
- * object is used to retrieve the <CODE>SOAPBody</CODE> and <CODE>
- * SOAPHeader</CODE> objects.
+ * method {@code SOAPMessage.getSOAPPart()}. The {@code
+ * SOAPEnvelope} object is retrieved from the {@code
+ * SOAPPart} object, and the {@code SOAPEnvelope}
+ * object is used to retrieve the {@code SOAPBody} and {@code
+ * SOAPHeader} objects.
  * <PRE>
  * SOAPPart sp = message.getSOAPPart();
  * SOAPEnvelope se = sp.getEnvelope();
@@ -59,28 +59,28 @@ import java.util.Iterator;
  * SOAPHeader sh = se.getHeader();
  * </PRE>
  *
- * <P>In addition to the mandatory <CODE>SOAPPart</CODE> object, a
- * <CODE>SOAPMessage</CODE> object may contain zero or more <CODE>
- * AttachmentPart</CODE> objects, each of which contains
- * application-specific data. The <CODE>SOAPMessage</CODE>
- * interface provides methods for creating <CODE>
- * AttachmentPart</CODE> objects and also for adding them to a
- * <CODE>SOAPMessage</CODE> object. A party that has received a
- * <CODE>SOAPMessage</CODE> object can examine its contents by
+ * <P>In addition to the mandatory {@code SOAPPart} object, a
+ * {@code SOAPMessage} object may contain zero or more {@code
+ * AttachmentPart} objects, each of which contains
+ * application-specific data. The {@code SOAPMessage}
+ * interface provides methods for creating {@code
+ * AttachmentPart} objects and also for adding them to a
+ * {@code SOAPMessage} object. A party that has received a
+ * {@code SOAPMessage} object can examine its contents by
  * retrieving individual attachment parts.</P>
  *
  * <P>Unlike the rest of a SOAP message, an attachment is not
  * required to be in XML format and can therefore be anything from
  * simple text to an image file. Consequently, any message content
- * that is not in XML format must be in an <CODE>
- * AttachmentPart</CODE> object.</P>
+ * that is not in XML format must be in an {@code
+ * AttachmentPart} object.</P>
  *
- * <P>A <CODE>MessageFactory</CODE> object creates new <CODE>
- * SOAPMessage</CODE> objects. If the <CODE>MessageFactory</CODE>
+ * <P>A {@code MessageFactory} object creates new {@code
+ * SOAPMessage} objects. If the {@code MessageFactory}
  * object was initialized with a messaging Profile, it produces
- * <CODE>SOAPMessage</CODE> objects that conform to that Profile.
- * For example, a <CODE>SOAPMessage</CODE> object created by a
- * <CODE>MessageFactory</CODE> object initialized with the ebXML
+ * {@code SOAPMessage} objects that conform to that Profile.
+ * For example, a {@code SOAPMessage} object created by a
+ * {@code MessageFactory} object initialized with the ebXML
  * Profile will have the appropriate ebXML headers.</P>
  * @see MessageFactory MessageFactory
  * @see AttachmentPart AttachmentPart
@@ -90,39 +90,39 @@ public abstract class SOAPMessage {
     public SOAPMessage() {}
 
     /**
-     * Retrieves a description of this <CODE>SOAPMessage</CODE>
+     * Retrieves a description of this {@code SOAPMessage}
      * object's content.
-     * @return  a <CODE>String</CODE> describing the content of this
-     *     message or <CODE>null</CODE> if no description has been
+     * @return  a {@code String} describing the content of this
+     *     message or {@code null} if no description has been
      *     set
      * @see #setContentDescription(java.lang.String) setContentDescription(java.lang.String)
      */
     public abstract String getContentDescription();
 
     /**
-     * Sets the description of this <CODE>SOAPMessage</CODE>
+     * Sets the description of this {@code SOAPMessage}
      * object's content with the given description.
-     * @param  description a <CODE>String</CODE>
+     * @param  description a {@code String}
      *     describing the content of this message
      * @see #getContentDescription() getContentDescription()
      */
     public abstract void setContentDescription(String description);
 
     /**
-     * Gets the SOAP part of this <CODE>SOAPMessage</CODE> object.
+     * Gets the SOAP part of this {@code SOAPMessage} object.
      *
      *
-     *   <P>If a <CODE>SOAPMessage</CODE> object contains one or
+     *   <P>If a {@code SOAPMessage} object contains one or
      *   more attachments, the SOAP Part must be the first MIME body
      *   part in the message.</P>
-     * @return the <CODE>SOAPPart</CODE> object for this <CODE>
-     *     SOAPMessage</CODE> object
+     * @return the {@code SOAPPart} object for this {@code
+     *     SOAPMessage} object
      */
     public abstract SOAPPart getSOAPPart();
 
     /**
-     * Removes all <CODE>AttachmentPart</CODE> objects that have
-     *   been added to this <CODE>SOAPMessage</CODE> object.
+     * Removes all {@code AttachmentPart} objects that have
+     *   been added to this {@code SOAPMessage} object.
      *
      *   <P>This method does not touch the SOAP part.</P>
      */
@@ -131,26 +131,26 @@ public abstract class SOAPMessage {
     /**
      * Gets a count of the number of attachments in this
      * message. This count does not include the SOAP part.
-     * @return  the number of <CODE>AttachmentPart</CODE> objects
-     *     that are part of this <CODE>SOAPMessage</CODE>
+     * @return  the number of {@code AttachmentPart} objects
+     *     that are part of this {@code SOAPMessage}
      *     object
      */
     public abstract int countAttachments();
 
     /**
-     * Retrieves all the <CODE>AttachmentPart</CODE> objects
-     * that are part of this <CODE>SOAPMessage</CODE> object.
+     * Retrieves all the {@code AttachmentPart} objects
+     * that are part of this {@code SOAPMessage} object.
      * @return  an iterator over all the attachments in this
      *     message
      */
     public abstract Iterator getAttachments();
 
     /**
-     * Retrieves all the <CODE>AttachmentPart</CODE> objects
+     * Retrieves all the {@code AttachmentPart} objects
      * that have header entries that match the specified headers.
      * Note that a returned attachment could have headers in
      * addition to those specified.
-     * @param   headers a <CODE>MimeHeaders</CODE>
+     * @param   headers a {@code MimeHeaders}
      *     object containing the MIME headers for which to
      *     search
      * @return an iterator over all attachments that have a header
@@ -159,83 +159,53 @@ public abstract class SOAPMessage {
     public abstract Iterator getAttachments(MimeHeaders headers);
 
     /**
-     * Adds the given <CODE>AttachmentPart</CODE> object to this
-     * <CODE>SOAPMessage</CODE> object. An <CODE>
-     * AttachmentPart</CODE> object must be created before it can be
+     * Adds the given {@code AttachmentPart} object to this
+     * {@code SOAPMessage} object. An {@code
+     * AttachmentPart} object must be created before it can be
      * added to a message.
-     * @param  attachmentpart an <CODE>
-     *     AttachmentPart</CODE> object that is to become part of
-     *     this <CODE>SOAPMessage</CODE> object
-     * @throws java.lang.IllegalArgumentException
+     * @param  attachmentpart an {@code
+     *     AttachmentPart} object that is to become part of
+     *     this {@code SOAPMessage} object
      */
     public abstract void addAttachmentPart(AttachmentPart attachmentpart);
 
     /**
-     * Creates a new empty <CODE>AttachmentPart</CODE> object.
-     * Note that the method <CODE>addAttachmentPart</CODE> must be
-     * called with this new <CODE>AttachmentPart</CODE> object as
+     * Creates a new empty {@code AttachmentPart} object.
+     * Note that the method {@code addAttachmentPart} must be
+     * called with this new {@code AttachmentPart} object as
      * the parameter in order for it to become an attachment to this
-     * <CODE>SOAPMessage</CODE> object.
-     * @return  a new <CODE>AttachmentPart</CODE> object that can be
-     *     populated and added to this <CODE>SOAPMessage</CODE>
+     * {@code SOAPMessage} object.
+     * @return  a new {@code AttachmentPart} object that can be
+     *     populated and added to this {@code SOAPMessage}
      *     object
      */
     public abstract AttachmentPart createAttachmentPart();
 
     /**
-     * Creates an <CODE>AttachmentPart</CODE> object and
-     * populates it using the given <CODE>DataHandler</CODE>
-     * object.
-     * @param   datahandler  the <CODE>
-     *     javax.activation.DataHandler</CODE> object that will
-     *     generate the content for this <CODE>SOAPMessage</CODE>
-     *     object
-     * @return a new <CODE>AttachmentPart</CODE> object that
-     *     contains data generated by the given <CODE>
-     *     DataHandler</CODE> object
-     * @throws java.lang.IllegalArgumentException if
-     *     there was a problem with the specified <CODE>
-     *     DataHandler</CODE> object
-     * @see DataHandler DataHandler
-     * @see javax.activation.DataContentHandler DataContentHandler
-     */
-// ericvas
-//    public AttachmentPart createAttachmentPart(DataHandler datahandler) {
-//
-//        AttachmentPart attachmentpart = createAttachmentPart();
-//
-//        attachmentpart.setDataHandler(datahandler);
-//
-//        return attachmentpart;
-//    }
-
-    /**
      * Returns all the transport-specific MIME headers for this
-     * <CODE>SOAPMessage</CODE> object in a transport-independent
+     * {@code SOAPMessage} object in a transport-independent
      * fashion.
-     * @return a <CODE>MimeHeaders</CODE> object containing the
-     *     <CODE>MimeHeader</CODE> objects
+     * @return a {@code MimeHeaders} object containing the
+     *     {@code MimeHeader} objects
      */
     public abstract MimeHeaders getMimeHeaders();
 
     /**
-     * Creates an <CODE>AttachmentPart</CODE> object and
+     * Creates an {@code AttachmentPart} object and
      * populates it with the specified data of the specified content
      * type.
-     * @param   content  an <CODE>Object</CODE>
-     *     containing the content for this <CODE>SOAPMessage</CODE>
+     * @param   content  an {@code Object}
+     *     containing the content for this {@code SOAPMessage}
      *     object
-     * @param   contentType a <CODE>String</CODE>
+     * @param   contentType a {@code String}
      *     object giving the type of content; examples are
      *     "text/xml", "text/plain", and "image/jpeg"
-     * @return a new <CODE>AttachmentPart</CODE> object that
+     * @return a new {@code AttachmentPart} object that
      *     contains the given data
      * @throws java.lang.IllegalArgumentException if the contentType does not match the type of the content
-     *     object, or if there was no <CODE>
-     *     DataContentHandler</CODE> object for the given content
+     *     object, or if there was no {@code
+     *     DataContentHandler} object for the given content
      *     object
-     * @see DataHandler DataHandler
-     * @see javax.activation.DataContentHandler DataContentHandler
      */
     public AttachmentPart createAttachmentPart(Object content,
                                                String contentType) {
@@ -248,24 +218,24 @@ public abstract class SOAPMessage {
     }
 
     /**
-     * Updates this <CODE>SOAPMessage</CODE> object with all the
+     * Updates this {@code SOAPMessage} object with all the
      *   changes that have been made to it. This method is called
      *   automatically when a message is sent or written to by the
-     *   methods <CODE>ProviderConnection.send</CODE>, <CODE>
-     *   SOAPConnection.call</CODE>, or <CODE>
-     *   SOAPMessage.writeTo</CODE>. However, if changes are made to
+     *   methods {@code ProviderConnection.send}, {@code
+     *   SOAPConnection.call}, or {@code
+     *   SOAPMessage.writeTo}. However, if changes are made to
      *   a message that was received or to one that has already been
-     *   sent, the method <CODE>saveChanges</CODE> needs to be
+     *   sent, the method {@code saveChanges} needs to be
      *   called explicitly in order to save the changes. The method
-     *   <CODE>saveChanges</CODE> also generates any changes that
+     *   {@code saveChanges} also generates any changes that
      *   can be read back (for example, a MessageId in profiles that
      *   support a message id). All MIME headers in a message that
      *   is created for sending purposes are guaranteed to have
-     *   valid values only after <CODE>saveChanges</CODE> has been
+     *   valid values only after {@code saveChanges} has been
      *   called.
      *
      *   <P>In addition, this method marks the point at which the
-     *   data from all constituent <CODE>AttachmentPart</CODE>
+     *   data from all constituent {@code AttachmentPart}
      *   objects are pulled into the message.</P>
      * @throws  SOAPException if there
      *     was a problem saving changes to this message.
@@ -273,25 +243,25 @@ public abstract class SOAPMessage {
     public abstract void saveChanges() throws SOAPException;
 
     /**
-     * Indicates whether this <CODE>SOAPMessage</CODE> object
-     * has had the method <CODE>saveChanges</CODE> called on
+     * Indicates whether this {@code SOAPMessage} object
+     * has had the method {@code saveChanges} called on
      * it.
-     * @return <CODE>true</CODE> if <CODE>saveChanges</CODE> has
-     *     been called on this message at least once; <CODE>
-     *     false</CODE> otherwise.
+     * @return {@code true} if {@code saveChanges} has
+     *     been called on this message at least once; {@code
+     *     false} otherwise.
      */
     public abstract boolean saveRequired();
 
     /**
-     * Writes this <CODE>SOAPMessage</CODE> object to the given
+     * Writes this {@code SOAPMessage} object to the given
      *   output stream. The externalization format is as defined by
      *   the SOAP 1.1 with Attachments specification.
      *
      *   <P>If there are no attachments, just an XML stream is
      *   written out. For those messages that have attachments,
-     *   <CODE>writeTo</CODE> writes a MIME-encoded byte stream.</P>
-     * @param   out the <CODE>OutputStream</CODE>
-     *     object to which this <CODE>SOAPMessage</CODE> object will
+     *   {@code writeTo} writes a MIME-encoded byte stream.</P>
+     * @param   out the {@code OutputStream}
+     *     object to which this {@code SOAPMessage} object will
      *     be written
      * @throws  SOAPException  if there was a problem in
      *     externalizing this SOAP message
@@ -302,20 +272,20 @@ public abstract class SOAPMessage {
         throws SOAPException, IOException;
 
     /**
-     * Gets the SOAP Body contained in this <code>SOAPMessage</code> object.
+     * Gets the SOAP Body contained in this {@code SOAPMessage} object.
      *
-     * @return the <code>SOAPBody</code> object contained by this
-     *              <code>SOAPMessage</code> object
+     * @return the {@code SOAPBody} object contained by this
+     *              {@code SOAPMessage} object
      * @throws SOAPException if the SOAP Body does not exist or cannot be
      *              retrieved
      */
     public abstract SOAPBody getSOAPBody() throws SOAPException;
 
     /**
-     * Gets the SOAP Header contained in this <code>SOAPMessage</code> object.
+     * Gets the SOAP Header contained in this {@code SOAPMessage} object.
      *
-     * @return the <code>SOAPHeader</code> object contained by this
-     *              <code>SOAPMessage</code> object
+     * @return the {@code SOAPHeader} object contained by this
+     *              {@code SOAPMessage} object
      * @throws SOAPException  if the SOAP Header does not exist or cannot be
      *              retrieved
      */
@@ -325,21 +295,21 @@ public abstract class SOAPMessage {
      * Associates the specified value with the specified property. If there was
      * already a value associated with this property, the old value is replaced.
      * <p>
-     * The valid property names include <code>WRITE_XML_DECLARATION</code> and
-     * <code>CHARACTER_SET_ENCODING</code>. All of these standard SAAJ
+     * The valid property names include {@code WRITE_XML_DECLARATION} and
+     * {@code CHARACTER_SET_ENCODING}. All of these standard SAAJ
      * properties are prefixed by "javax.xml.soap". Vendors may also add
      * implementation specific properties. These properties must be prefixed
      * with package names that are unique to the vendor.
      * <p>
-     * Setting the property <code>WRITE_XML_DECLARATION</code> to
-     * <code>"true"</code> will cause an XML Declaration to be written out at
+     * Setting the property {@code WRITE_XML_DECLARATION} to
+     * {@code "true"} will cause an XML Declaration to be written out at
      * the start of the SOAP message. The default value of "false" suppresses
      * this declaration.
      * <p>
-     * The property <code>CHARACTER_SET_ENCODING</code> defaults to the value
-     * <code>"utf-8"</code> which causes the SOAP message to be encoded using
-     * UTF-8. Setting <code>CHARACTER_SET_ENCODING</code> to
-     * <code>"utf-16"</code> causes the SOAP message to be encoded using UTF-16.
+     * The property {@code CHARACTER_SET_ENCODING} defaults to the value
+     * {@code "utf-8"} which causes the SOAP message to be encoded using
+     * UTF-8. Setting {@code CHARACTER_SET_ENCODING} to
+     * {@code "utf-16"} causes the SOAP message to be encoded using UTF-16.
      * <p>
      * Some implementations may allow encodings in addition to UTF-8 and UTF-16.
      * Refer to your vendor's documentation for details.
@@ -356,7 +326,7 @@ public abstract class SOAPMessage {
      * Retrieves value of the specified property.
      *
      * @param property the name of the property to retrieve
-     * @return the value of the property or <code>null</code> if no such
+     * @return the value of the property or {@code null} if no such
      *              property exists
      * @throws SOAPException  if the property name is not recognized
      */

Modified: xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/soap/SOAPPart.java
URL: http://svn.apache.org/viewvc/xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/soap/SOAPPart.java?rev=1896561&r1=1896560&r2=1896561&view=diff
==============================================================================
--- xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/soap/SOAPPart.java (original)
+++ xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/soap/SOAPPart.java Fri Dec 31 00:01:16 2021
@@ -19,21 +19,21 @@ import javax.xml.transform.Source;
 import java.util.Iterator;
 
 /**
- * <P>The container for the SOAP-specific portion of a <CODE>
- * SOAPMessage</CODE> object. All messages are required to have a
- * SOAP part, so when a <CODE>SOAPMessage</CODE> object is
- * created, it will automatically have a <CODE>SOAPPart</CODE>
+ * <P>The container for the SOAP-specific portion of a {@code
+ * SOAPMessage} object. All messages are required to have a
+ * SOAP part, so when a {@code SOAPMessage} object is
+ * created, it will automatically have a {@code SOAPPart}
  * object.</P>
  *
- * <P>A <CODE>SOAPPart</CODE> object is a MIME part and has the
+ * <P>A {@code SOAPPart} object is a MIME part and has the
  * MIME headers Content-Id, Content-Location, and Content-Type.
- * Because the value of Content-Type must be "text/xml", a <CODE>
- * SOAPPart</CODE> object automatically has a MIME header of
+ * Because the value of Content-Type must be "text/xml", a {@code
+ * SOAPPart} object automatically has a MIME header of
  * Content-Type with its value set to "text/xml". The value must
  * be "text/xml" because content in the SOAP part of a message
  * must be in XML format. Content that is not of type "text/xml"
- * must be in an <CODE>AttachmentPart</CODE> object rather than in
- * the <CODE>SOAPPart</CODE> object.</P>
+ * must be in an {@code AttachmentPart} object rather than in
+ * the {@code SOAPPart} object.</P>
  *
  * <P>When a message is sent, its SOAP part must have the MIME
  * header Content-Type set to "text/xml". Or, from the other
@@ -41,31 +41,31 @@ import java.util.Iterator;
  * have the MIME header Content-Type with a value of
  * "text/xml".</P>
  *
- * <P>A client can access the <CODE>SOAPPart</CODE> object of a
- * <CODE>SOAPMessage</CODE> object by calling the method <CODE>
- * SOAPMessage.getSOAPPart</CODE>. The following line of code, in
- * which <CODE>message</CODE> is a <CODE>SOAPMessage</CODE>
+ * <P>A client can access the {@code SOAPPart} object of a
+ * {@code SOAPMessage} object by calling the method {@code
+ * SOAPMessage.getSOAPPart}. The following line of code, in
+ * which {@code message} is a {@code SOAPMessage}
  * object, retrieves the SOAP part of a message.</P>
  * <PRE>
  * SOAPPart soapPart = message.getSOAPPart();
  * </PRE>
  *
- * <P>A <CODE>SOAPPart</CODE> object contains a <CODE>
- * SOAPEnvelope</CODE> object, which in turn contains a <CODE>
- * SOAPBody</CODE> object and a <CODE>SOAPHeader</CODE> object.
- * The <CODE>SOAPPart</CODE> method <CODE>getEnvelope</CODE> can
- * be used to retrieve the <CODE>SOAPEnvelope</CODE> object.</P>
+ * <P>A {@code SOAPPart} object contains a {@code
+ * SOAPEnvelope} object, which in turn contains a {@code
+ * SOAPBody} object and a {@code SOAPHeader} object.
+ * The {@code SOAPPart} method {@code getEnvelope} can
+ * be used to retrieve the {@code SOAPEnvelope} object.</P>
  */
 public abstract class SOAPPart implements org.w3c.dom.Document {
 
     public SOAPPart() {}
 
     /**
-     * Gets the <CODE>SOAPEnvelope</CODE> object associated with
-     * this <CODE>SOAPPart</CODE> object. Once the SOAP envelope is
+     * Gets the {@code SOAPEnvelope} object associated with
+     * this {@code SOAPPart} object. Once the SOAP envelope is
      * obtained, it can be used to get its contents.
-     * @return the <CODE>SOAPEnvelope</CODE> object for this <CODE>
-     *     SOAPPart</CODE> object
+     * @return the {@code SOAPEnvelope} object for this {@code
+     *     SOAPPart} object
      * @throws  SOAPException if there is a SOAP error
      */
     public abstract SOAPEnvelope getEnvelope() throws SOAPException;
@@ -73,13 +73,13 @@ public abstract class SOAPPart implement
     /**
      * Retrieves the value of the MIME header whose name is
      * "Content-Id".
-     * @return  a <CODE>String</CODE> giving the value of the MIME
+     * @return  a {@code String} giving the value of the MIME
      *     header named "Content-Id"
      * @see #setContentId(java.lang.String) setContentId(java.lang.String)
      */
     public String getContentId() {
 
-        String as[] = getMimeHeader("Content-Id");
+        String[] as = getMimeHeader("Content-Id");
 
         if (as != null && as.length > 0) {
             return as[0];
@@ -91,13 +91,13 @@ public abstract class SOAPPart implement
     /**
      * Retrieves the value of the MIME header whose name is
      * "Content-Location".
-     * @return a <CODE>String</CODE> giving the value of the MIME
+     * @return a {@code String} giving the value of the MIME
      *     header whose name is "Content-Location"
      * @see #setContentLocation(java.lang.String) setContentLocation(java.lang.String)
      */
     public String getContentLocation() {
 
-        String as[] = getMimeHeader("Content-Location");
+        String[] as = getMimeHeader("Content-Location");
 
         if (as != null && as.length > 0) {
             return as[0];
@@ -108,8 +108,8 @@ public abstract class SOAPPart implement
 
     /**
      * Sets the value of the MIME header named "Content-Id" to
-     * the given <CODE>String</CODE>.
-     * @param  contentId  a <CODE>String</CODE> giving
+     * the given {@code String}.
+     * @param  contentId  a {@code String} giving
      *     the value of the MIME header "Content-Id"
      * @throws java.lang.IllegalArgumentException if
      *     there is a problem in setting the content id
@@ -121,8 +121,8 @@ public abstract class SOAPPart implement
 
     /**
      * Sets the value of the MIME header "Content-Location" to
-     * the given <CODE>String</CODE>.
-     * @param  contentLocation a <CODE>String</CODE>
+     * the given {@code String}.
+     * @param  contentLocation a {@code String}
      *     giving the value of the MIME header
      *     "Content-Location"
      * @throws java.lang.IllegalArgumentException if
@@ -135,24 +135,24 @@ public abstract class SOAPPart implement
 
     /**
      * Removes all MIME headers that match the given name.
-     * @param  header  a <CODE>String</CODE> giving
+     * @param  header  a {@code String} giving
      *     the name of the MIME header(s) to be removed
      */
     public abstract void removeMimeHeader(String header);
 
     /**
-     * Removes all the <CODE>MimeHeader</CODE> objects for this
-     * <CODE>SOAPEnvelope</CODE> object.
+     * Removes all the {@code MimeHeader} objects for this
+     * {@code SOAPEnvelope} object.
      */
     public abstract void removeAllMimeHeaders();
 
     /**
-     * Gets all the values of the <CODE>MimeHeader</CODE> object
-     * in this <CODE>SOAPPart</CODE> object that is identified by
-     * the given <CODE>String</CODE>.
+     * Gets all the values of the {@code MimeHeader} object
+     * in this {@code SOAPPart} object that is identified by
+     * the given {@code String}.
      * @param   name  the name of the header; example:
      *     "Content-Type"
-     * @return a <CODE>String</CODE> array giving all the values for
+     * @return a {@code String} array giving all the values for
      *     the specified header
      * @see #setMimeHeader(java.lang.String, java.lang.String) setMimeHeader(java.lang.String, java.lang.String)
      */
@@ -170,13 +170,13 @@ public abstract class SOAPPart implement
      *
      *   <P>Note that RFC822 headers can contain only US-ASCII
      *   characters.</P>
-     * @param  name a <CODE>String</CODE> giving the
+     * @param  name a {@code String} giving the
      *     header name for which to search
-     * @param  value a <CODE>String</CODE> giving the
+     * @param  value a {@code String} giving the
      *     value to be set. This value will be substituted for the
      *     current value(s) of the first header that is a match if
      *     there is one. If there is no match, this value will be
-     *     the value for a new <CODE>MimeHeader</CODE> object.
+     *     the value for a new {@code MimeHeader} object.
      * @throws java.lang.IllegalArgumentException if
      *     there was a problem with the specified mime header name
      *     or value
@@ -186,18 +186,18 @@ public abstract class SOAPPart implement
     public abstract void setMimeHeader(String name, String value);
 
     /**
-     *  Creates a <CODE>MimeHeader</CODE> object with the specified
-     *   name and value and adds it to this <CODE>SOAPPart</CODE>
-     *   object. If a <CODE>MimeHeader</CODE> with the specified
+     *  Creates a {@code MimeHeader} object with the specified
+     *   name and value and adds it to this {@code SOAPPart}
+     *   object. If a {@code MimeHeader} with the specified
      *   name already exists, this method adds the specified value
      *   to the already existing value(s).
      *
      *   <P>Note that RFC822 headers can contain only US-ASCII
      *   characters.</P>
      *
-     * @param  name a <CODE>String</CODE> giving the
+     * @param  name a {@code String} giving the
      *     header name
-     * @param  value a <CODE>String</CODE> giving the
+     * @param  value a {@code String} giving the
      *     value to be set or added
      * @throws java.lang.IllegalArgumentException if
      * there was a problem with the specified mime header name
@@ -206,41 +206,41 @@ public abstract class SOAPPart implement
     public abstract void addMimeHeader(String name, String value);
 
     /**
-     * Retrieves all the headers for this <CODE>SOAPPart</CODE>
-     * object as an iterator over the <CODE>MimeHeader</CODE>
+     * Retrieves all the headers for this {@code SOAPPart}
+     * object as an iterator over the {@code MimeHeader}
      * objects.
-     * @return an <CODE>Iterator</CODE> object with all of the Mime
-     *     headers for this <CODE>SOAPPart</CODE> object
+     * @return an {@code Iterator} object with all of the Mime
+     *     headers for this {@code SOAPPart} object
      */
     public abstract Iterator getAllMimeHeaders();
 
     /**
-     * Retrieves all <CODE>MimeHeader</CODE> objects that match
+     * Retrieves all {@code MimeHeader} objects that match
      * a name in the given array.
-     * @param   names a <CODE>String</CODE> array with
+     * @param   names a {@code String} array with
      *     the name(s) of the MIME headers to be returned
      * @return all of the MIME headers that match one of the names
-     *     in the given array, returned as an <CODE>Iterator</CODE>
+     *     in the given array, returned as an {@code Iterator}
      *     object
      */
-    public abstract Iterator getMatchingMimeHeaders(String names[]);
+    public abstract Iterator getMatchingMimeHeaders(String[] names);
 
     /**
-     * Retrieves all <CODE>MimeHeader</CODE> objects whose name
+     * Retrieves all {@code MimeHeader} objects whose name
      * does not match a name in the given array.
-     * @param   names a <CODE>String</CODE> array with
+     * @param   names a {@code String} array with
      *     the name(s) of the MIME headers not to be returned
-     * @return all of the MIME headers in this <CODE>SOAPPart</CODE>
+     * @return all of the MIME headers in this {@code SOAPPart}
      *     object except those that match one of the names in the
      *     given array. The nonmatching MIME headers are returned as
-     *     an <CODE>Iterator</CODE> object.
+     *     an {@code Iterator} object.
      */
-    public abstract Iterator getNonMatchingMimeHeaders(String names[]);
+    public abstract Iterator getNonMatchingMimeHeaders(String[] names);
 
     /**
-     * Sets the content of the <CODE>SOAPEnvelope</CODE> object
-     * with the data from the given <CODE>Source</CODE> object.
-     * @param   source javax.xml.transform.Source</CODE> object with the data to
+     * Sets the content of the {@code SOAPEnvelope} object
+     * with the data from the given {@code Source} object.
+     * @param   source {@code javax.xml.transform.Source} object with the data to
      *     be set
      * @throws  SOAPException if there is a problem in
      *     setting the source
@@ -249,12 +249,12 @@ public abstract class SOAPPart implement
     public abstract void setContent(Source source) throws SOAPException;
 
     /**
-     * Returns the content of the SOAPEnvelope as a JAXP <CODE>
-     * Source</CODE> object.
-     * @return the content as a <CODE>
-     *     javax.xml.transform.Source</CODE> object
+     * Returns the content of the SOAPEnvelope as a JAXP {@code
+     * Source} object.
+     * @return the content as a {@code
+     *     javax.xml.transform.Source} object
      * @throws  SOAPException  if the implementation cannot
-     *     convert the specified <CODE>Source</CODE> object
+     *     convert the specified {@code Source} object
      * @see #setContent(javax.xml.transform.Source) setContent(javax.xml.transform.Source)
      */
     public abstract Source getContent() throws SOAPException;

Modified: xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/soap/Text.java
URL: http://svn.apache.org/viewvc/xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/soap/Text.java?rev=1896561&r1=1896560&r2=1896561&view=diff
==============================================================================
--- xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/soap/Text.java (original)
+++ xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/soap/Text.java Fri Dec 31 00:01:16 2021
@@ -16,17 +16,17 @@
 package org.apache.xmlbeans.impl.soap;
 
 /**
- * A representation of a node whose value is text. A <CODE>
- *   Text</CODE> object may represent text that is content or text
+ * A representation of a node whose value is text. A {@code
+ *   Text} object may represent text that is content or text
  *   that is a comment.
  */
 public interface Text extends Node, org.w3c.dom.Text {
 
     /**
-     * Retrieves whether this <CODE>Text</CODE> object
+     * Retrieves whether this {@code Text} object
      * represents a comment.
-     * @return  <CODE>true</CODE> if this <CODE>Text</CODE> object is
-     *     a comment; <CODE>false</CODE> otherwise
+     * @return  {@code true} if this {@code Text} object is
+     *     a comment; {@code false} otherwise
      */
-    public abstract boolean isComment();
+    boolean isComment();
 }

Modified: xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/store/DomImpl.java
URL: http://svn.apache.org/viewvc/xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/store/DomImpl.java?rev=1896561&r1=1896560&r2=1896561&view=diff
==============================================================================
--- xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/store/DomImpl.java (original)
+++ xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/store/DomImpl.java Fri Dec 31 00:01:16 2021
@@ -319,6 +319,11 @@ public final class DomImpl {
 
     private static String validatePrefix(
         String prefix, String uri, String local, boolean isAttr) {
+
+        if (prefix != null && prefix.contains(":")) {
+            throw new NamespaceErr("Invalid prefix - contains ':' character");
+        }
+
         validateNcName(prefix);
 
         if (prefix == null) {

Modified: xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/store/Locale.java
URL: http://svn.apache.org/viewvc/xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/store/Locale.java?rev=1896561&r1=1896560&r2=1896561&view=diff
==============================================================================
--- xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/store/Locale.java (original)
+++ xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/store/Locale.java Fri Dec 31 00:01:16 2021
@@ -2177,7 +2177,10 @@ public final class Locale
 
         protected boolean isAttrOfTypeId(QName aqn, QName eqn) {
             if (_idAttrs == null) {
-                return false;
+                // as most documents are either without schema or based on xml schema
+                // which ID attributes aren't promoted by the SAXParser, the workaround
+                // is to simply accept all "id" attributes
+                return "id".equalsIgnoreCase(aqn.getLocalPart());
             }
             String pre = aqn.getPrefix();
             String lName = aqn.getLocalPart();
@@ -2459,6 +2462,7 @@ public final class Locale
 
         //DeclHandler
         public void attributeDecl(String eName, String aName, String type, String valueDefault, String value) {
+            // the DeclHandler is only called for DTD based documents
             if (type.equals("ID")) {
                 _context.addIdAttr(eName, aName);
             }

Modified: xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/tool/CodeGenUtil.java
URL: http://svn.apache.org/viewvc/xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/tool/CodeGenUtil.java?rev=1896561&r1=1896560&r2=1896561&view=diff
==============================================================================
--- xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/tool/CodeGenUtil.java (original)
+++ xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/tool/CodeGenUtil.java Fri Dec 31 00:01:16 2021
@@ -80,7 +80,7 @@ public class CodeGenUtil {
     /**
      * Invokes javac on the generated source files in order to turn them
      * into binary files in the output directory.  This will return a list of
-     * <code>GenFile</code>s for all of the classes produced or null if an
+     * {@code GenFile}s for all of the classes produced or null if an
      * error occurred.
      *
      * @deprecated
@@ -97,7 +97,7 @@ public class CodeGenUtil {
     /**
      * Invokes javac on the generated source files in order to turn them
      * into binary files in the output directory.  This will return a list of
-     * <code>GenFile</code>s for all of the classes produced or null if an
+     * {@code GenFile}s for all of the classes produced or null if an
      * error occurred.
      */
     public static boolean externalCompile(List<File> srcFiles, File outdir, File[] cp, boolean debug, String javacPath, String genver, String memStart, String memMax, boolean quiet, boolean verbose) {

Modified: xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/tool/FactorImports.java
URL: http://svn.apache.org/viewvc/xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/tool/FactorImports.java?rev=1896561&r1=1896560&r2=1896561&view=diff
==============================================================================
--- xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/tool/FactorImports.java (original)
+++ xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/tool/FactorImports.java Fri Dec 31 00:01:16 2021
@@ -29,7 +29,7 @@ import java.util.*;
 /**
  * This program takes a collection of .xsd files as input, finds all duplicate
  * name definitions, and factors out the first instance of each of those into
- * a common.xsd file, adding an appropriate <import> statement in the original
+ * a common.xsd file, adding an appropriate {@code <import>} statement in the original
  * xsd file.
  */
 public class FactorImports {

Modified: xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/tool/MavenPluginHelp.java
URL: http://svn.apache.org/viewvc/xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/tool/MavenPluginHelp.java?rev=1896561&r1=1896560&r2=1896561&view=diff
==============================================================================
--- xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/tool/MavenPluginHelp.java (original)
+++ xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/tool/MavenPluginHelp.java Fri Dec 31 00:01:16 2021
@@ -34,7 +34,7 @@ import java.util.List;
 
 /**
  * Display help information on xmlbeans-maven-plugin.<br>
- * Call <code>mvn xmlbeans.plugin:help -Ddetail=true -Dgoal=&lt;goal-name&gt;</code> to display parameter details.
+ * Call {@code mvn xmlbeans.plugin:help -Ddetail=true -Dgoal=&lt;goal-name&gt;} to display parameter details.
  */
 @Mojo(name = "help", requiresProject = false, threadSafe = true)
 public class MavenPluginHelp extends AbstractMojo {
@@ -45,7 +45,7 @@ public class MavenPluginHelp extends Abs
 
 
     /**
-     * If <code>true</code>, display all settable properties for each goal.
+     * If {@code true}, display all settable properties for each goal.
      */
     @Parameter(property = "detail", defaultValue = "false")
     private boolean detail;
@@ -248,13 +248,13 @@ public class MavenPluginHelp extends Abs
     }
 
     /**
-     * <p>Repeat a String <code>n</code> times to form a new string.</p>
+     * <p>Repeat a String {@code n} times to form a new string.</p>
      *
      * @param str    String to repeat
      * @param repeat number of times to repeat str
      * @return String with repeated String
-     * @throws NegativeArraySizeException if <code>repeat &lt; 0</code>
-     * @throws NullPointerException       if str is <code>null</code>
+     * @throws NegativeArraySizeException if {@code repeat &lt; 0}
+     * @throws NullPointerException       if str is {@code null}
      */
     private static String repeat(String str, int repeat) {
         StringBuilder buffer = new StringBuilder(repeat * str.length());
@@ -270,8 +270,8 @@ public class MavenPluginHelp extends Abs
      * Append a description to the buffer by respecting the indentSize and lineLength parameters.
      * <b>Note</b>: The last character is always a new line.
      *
-     * @param sb          The buffer to append the description, not <code>null</code>.
-     * @param description The description, not <code>null</code>.
+     * @param sb          The buffer to append the description, not {@code null}.
+     * @param description The description, not {@code null}.
      * @param indent      The base indentation level of each line, must not be negative.
      */
     private void append(StringBuilder sb, String description, int indent) {
@@ -283,12 +283,12 @@ public class MavenPluginHelp extends Abs
     /**
      * Splits the specified text into lines of convenient display length.
      *
-     * @param text       The text to split into lines, must not be <code>null</code>.
+     * @param text       The text to split into lines, must not be {@code null}.
      * @param indent     The base indentation level of each line, must not be negative.
      * @param indentSize The size of each indentation, must not be negative.
      * @param lineLength The length of the line, must not be negative.
-     * @return The sequence of display lines, never <code>null</code>.
-     * @throws NegativeArraySizeException if <code>indent &lt; 0</code>
+     * @return The sequence of display lines, never {@code null}.
+     * @throws NegativeArraySizeException if {@code indent &lt; 0}
      */
     private static List<String> toLines(String text, int indent, int indentSize, int lineLength) {
         List<String> lines = new ArrayList<>();
@@ -307,8 +307,8 @@ public class MavenPluginHelp extends Abs
     /**
      * Adds the specified line to the output sequence, performing line wrapping if necessary.
      *
-     * @param lines      The sequence of display lines, must not be <code>null</code>.
-     * @param line       The line to add, must not be <code>null</code>.
+     * @param lines      The sequence of display lines, must not be {@code null}.
+     * @param line       The line to add, must not be {@code null}.
      * @param indentSize The size of each indentation, must not be negative.
      * @param lineLength The length of the line, must not be negative.
      */
@@ -346,7 +346,7 @@ public class MavenPluginHelp extends Abs
     /**
      * Gets the indentation level of the specified line.
      *
-     * @param line The line whose indentation level should be retrieved, must not be <code>null</code>.
+     * @param line The line whose indentation level should be retrieved, must not be {@code null}.
      * @return The indentation level of the line.
      */
     private static int getIndentLevel(String line) {

Modified: xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/tool/SchemaCodeGenerator.java
URL: http://svn.apache.org/viewvc/xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/tool/SchemaCodeGenerator.java?rev=1896561&r1=1896560&r2=1896561&view=diff
==============================================================================
--- xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/tool/SchemaCodeGenerator.java (original)
+++ xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/tool/SchemaCodeGenerator.java Fri Dec 31 00:01:16 2021
@@ -30,7 +30,7 @@ public class SchemaCodeGenerator {
     /**
      * Saves a SchemaTypeSystem to the specified directory.
      *
-     * @param system     the <code>SchemaTypeSystem</code> to save
+     * @param system     the {@code SchemaTypeSystem} to save
      * @param classesDir the destination directory for xsb's
      * @param sourceFile if present, the TypeSystemHolder source will be
      *                   generated in this file for subsequent compilation,

Modified: xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/tool/SchemaCompiler.java
URL: http://svn.apache.org/viewvc/xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/tool/SchemaCompiler.java?rev=1896561&r1=1896560&r2=1896561&view=diff
==============================================================================
--- xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/tool/SchemaCompiler.java (original)
+++ xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/tool/SchemaCompiler.java Fri Dec 31 00:01:16 2021
@@ -571,16 +571,16 @@ public class SchemaCompiler {
         XmlObject[] types = wsdldoc.getDefinitions().getTypesArray();
         int count = 0;
         for (XmlObject type : types) {
-            Schema[] schemas = (Schema[]) type.selectPath("declare namespace xs=\"http://www.w3.org/2001/XMLSchema\" xs:schema");
+            XmlObject[] schemas = type.selectPath("declare namespace xs=\"http://www.w3.org/2001/XMLSchema\" xs:schema");
             if (schemas.length == 0) {
                 StscState.addWarning(errorListener, "The WSDL " + name + " did not have any schema documents in namespace 'http://www.w3.org/2001/XMLSchema'", XmlErrorCodes.GENERIC_ERROR, wsdldoc);
                 continue;
             }
 
-            for (Schema schema : schemas) {
+            for (XmlObject schema : schemas) {
                 if (schema.validate(opts)) {
                     count++;
-                    scontentlist.add(schema);
+                    scontentlist.add((Schema)schema);
                 }
             }
         }

Modified: xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/validator/ValidatingInfoXMLStreamReader.java
URL: http://svn.apache.org/viewvc/xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/validator/ValidatingInfoXMLStreamReader.java?rev=1896561&r1=1896560&r2=1896561&view=diff
==============================================================================
--- xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/validator/ValidatingInfoXMLStreamReader.java (original)
+++ xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/validator/ValidatingInfoXMLStreamReader.java Fri Dec 31 00:01:16 2021
@@ -14,27 +14,18 @@
  */
 package org.apache.xmlbeans.impl.validator;
 
-import org.apache.xmlbeans.SchemaType;
-import org.apache.xmlbeans.SchemaLocalElement;
-import org.apache.xmlbeans.SchemaParticle;
-import org.apache.xmlbeans.SchemaLocalAttribute;
-import org.apache.xmlbeans.SchemaAttributeModel;
-import org.apache.xmlbeans.GDate;
-import org.apache.xmlbeans.GDuration;
+import org.apache.xmlbeans.*;
 
-import javax.xml.stream.XMLStreamReader;
+import javax.xml.namespace.QName;
 import javax.xml.stream.XMLStreamException;
+import javax.xml.stream.XMLStreamReader;
 import javax.xml.stream.events.XMLEvent;
-import javax.xml.namespace.QName;
 import java.math.BigDecimal;
 import java.util.List;
 
 /**
  * Extension of {@link ValidatingXMLStreamReader} to provide Post Schema Validation Info
  * over an XMLStreamReader.
- *
- * @author Cezar Andrei (cezar.andrei at bea.com)
- *         Date: Aug 17, 2004
  */
 public class ValidatingInfoXMLStreamReader
     extends ValidatingXMLStreamReader

Modified: xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/validator/ValidatingXMLStreamReader.java
URL: http://svn.apache.org/viewvc/xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/validator/ValidatingXMLStreamReader.java?rev=1896561&r1=1896560&r2=1896561&view=diff
==============================================================================
--- xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/validator/ValidatingXMLStreamReader.java (original)
+++ xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/validator/ValidatingXMLStreamReader.java Fri Dec 31 00:01:16 2021
@@ -14,19 +14,15 @@
  */
 package org.apache.xmlbeans.impl.validator;
 
-import org.apache.xmlbeans.SchemaType;
-import org.apache.xmlbeans.SchemaTypeLoader;
-import org.apache.xmlbeans.XmlCursor;
-import org.apache.xmlbeans.XmlError;
-import org.apache.xmlbeans.XmlOptions;
+import org.apache.xmlbeans.*;
+import org.apache.xmlbeans.impl.common.QNameHelper;
 import org.apache.xmlbeans.impl.common.ValidatorListener;
 import org.apache.xmlbeans.impl.common.XmlWhitespace;
-import org.apache.xmlbeans.impl.common.QNameHelper;
 
 import javax.xml.namespace.QName;
+import javax.xml.stream.Location;
 import javax.xml.stream.XMLStreamException;
 import javax.xml.stream.XMLStreamReader;
-import javax.xml.stream.Location;
 import javax.xml.stream.events.XMLEvent;
 import javax.xml.stream.util.StreamReaderDelegate;
 import java.util.ArrayList;
@@ -36,17 +32,14 @@ import java.util.List;
 /**
  * This class is a wrapper over a generic XMLStreamReader that provides validation.
  * There are 3 cases:
- * <br/> 1) the XMLStreamReader represents a document, it contains only one element document
+ * <br> 1) the XMLStreamReader represents a document, it contains only one element document
  *          - in this case the user schema type should be null or it should be a document SchemaType
- * <br/> 2) the XMLStreamReader represents an xml-fragment (content only) - must have at least one user type or xsi:type
- * <br/>     a) it has an xsi:type - if user schema type is available it has to be a base type of xsi:type
- * <br/>     b) it doesn't have xsi:type - user must provide a schema type
+ * <br> 2) the XMLStreamReader represents an xml-fragment (content only) - must have at least one user type or xsi:type
+ * <br>     a) it has an xsi:type - if user schema type is available it has to be a base type of xsi:type
+ * <br>     b) it doesn't have xsi:type - user must provide a schema type
  *         otherwise will error and will not do validation
- * <br/> 3) the XMLStreamReader represents a global attribute - i.e. user schema type is null and only one attribute
- * <br/>
- *
- * @author Cezar Andrei (cezar.andrei at bea.com)
- * Date: Feb 13, 2004
+ * <br> 3) the XMLStreamReader represents a global attribute - i.e. user schema type is null and only one attribute
+ * <br>
  */
 public class ValidatingXMLStreamReader
     extends StreamReaderDelegate

Modified: xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/values/JavaDecimalHolder.java
URL: http://svn.apache.org/viewvc/xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/values/JavaDecimalHolder.java?rev=1896561&r1=1896560&r2=1896561&view=diff
==============================================================================
--- xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/values/JavaDecimalHolder.java (original)
+++ xmlbeans/trunk/src/main/java/org/apache/xmlbeans/impl/values/JavaDecimalHolder.java Fri Dec 31 00:01:16 2021
@@ -153,7 +153,7 @@ public class JavaDecimalHolder extends X
 
     /**
      * This method will has BigDecimals with the same arithmetic value to
-     * the same hash code (eg, 2.3 & 2.30 will have the same hash.)
+     * the same hash code (eg, 2.3 &amp; 2.30 will have the same hash.)
      * This differs from BigDecimal.hashCode()
      */
     protected int decimalHashCode() {



---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@poi.apache.org
For additional commands, e-mail: commits-help@poi.apache.org