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=<goal-name></code> to display parameter details. + * Call {@code mvn xmlbeans.plugin:help -Ddetail=true -Dgoal=<goal-name>} 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 < 0</code> - * @throws NullPointerException if str is <code>null</code> + * @throws NegativeArraySizeException if {@code repeat < 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 < 0</code> + * @return The sequence of display lines, never {@code null}. + * @throws NegativeArraySizeException if {@code indent < 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 & 2.30 will have the same hash.) * This differs from BigDecimal.hashCode() */ protected int decimalHashCode() { --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
