src/java.xml.ws/share/classes/javax/xml/ws/handler/soap/SOAPMessageContext.java

@@ -1,7 +1,7 @@
 /*
- * Copyright (c) 2005, 2012, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
  * under the terms of the GNU General Public License version 2 only, as
  * published by the Free Software Foundation.  Oracle designates this

@@ -28,37 +28,37 @@
 import javax.xml.soap.SOAPMessage;
 import javax.xml.bind.JAXBContext;
 import javax.xml.namespace.QName;
 import java.util.Set;
 
-/** The interface <code>SOAPMessageContext</code>
+/** The interface {@code SOAPMessageContext}
  *  provides access to the SOAP message for either RPC request or
- *  response. The <code>javax.xml.soap.SOAPMessage</code> specifies
+ *  response. The {@code javax.xml.soap.SOAPMessage} specifies
  *  the standard Java API for the representation of a SOAP 1.1 message
  *  with attachments.
  *
  *  @see javax.xml.soap.SOAPMessage
  *
  *  @since 1.6, JAX-WS 2.0
 **/
 public interface SOAPMessageContext
                     extends javax.xml.ws.handler.MessageContext {
 
-  /** Gets the <code>SOAPMessage</code> from this message context. Modifications
-   *  to the returned <code>SOAPMessage</code> change the message in-place, there
-   *  is no need to subsequently call <code>setMessage</code>.
+  /** Gets the {@code SOAPMessage} from this message context. Modifications
+   *  to the returned {@code SOAPMessage} change the message in-place, there
+   *  is no need to subsequently call {@code setMessage}.
    *
-   *  @return Returns the <code>SOAPMessage</code>; returns <code>null</code> if no
-   *          <code>SOAPMessage</code> is present in this message context
+   *  @return Returns the {@code SOAPMessage}; returns {@code null} if no
+   *          {@code SOAPMessage} is present in this message context
   **/
   public SOAPMessage getMessage();
 
   /** Sets the SOAPMessage in this message context
    *
    *  @param  message SOAP message
-   *  @throws WebServiceException If any error during the setting
-   *          of the <code>SOAPMessage</code> in this message context
+   *  @throws javax.xml.ws.WebServiceException If any error during the setting
+   *          of the {@code SOAPMessage} in this message context
    *  @throws java.lang.UnsupportedOperationException If this
    *          operation is not supported
   **/
   public void setMessage(SOAPMessage message);
 

@@ -67,33 +67,33 @@
    *  with the same qualified name.
    *
    *  @param  header The XML qualified name of the SOAP header(s).
    *  @param  context The JAXBContext that should be used to unmarshall the
    *          header
-   *  @param  allRoles If <code>true</code> then returns headers for all SOAP
-   *          roles, if <code>false</code> then only returns headers targetted
+   *  @param  allRoles If {@code true} then returns headers for all SOAP
+   *          roles, if {@code false} then only returns headers targetted
    *          at the roles currently being played by this SOAP node, see
-   *          <code>getRoles</code>.
+   *          {@code getRoles}.
    *  @return An array of unmarshalled headers; returns an empty array if no
    *          message is present in this message context or no headers match
    *          the supplied qualified name.
-   *  @throws WebServiceException If an error occurs when using the supplied
-   *     <code>JAXBContext</code> to unmarshall. The cause of
-   *     the <code>WebServiceException</code> is the original <code>JAXBException</code>.
+   *  @throws javax.xml.ws.WebServiceException If an error occurs when using the supplied
+   *     {@code JAXBContext} to unmarshall. The cause of
+   *     the {@code WebServiceException} is the original {@code JAXBException}.
   **/
   public Object[] getHeaders(QName header, JAXBContext context,
     boolean allRoles);
 
   /** Gets the SOAP actor roles associated with an execution
    *  of the handler chain.
    *  Note that SOAP actor roles apply to the SOAP node and
    *  are managed using {@link javax.xml.ws.soap.SOAPBinding#setRoles} and
-   *  {@link javax.xml.ws.soap.SOAPBinding#getRoles}. <code>Handler</code> instances in
+   *  {@link javax.xml.ws.soap.SOAPBinding#getRoles}. {@code Handler} instances in
    *  the handler chain use this information about the SOAP actor
    *  roles to process the SOAP header blocks. Note that the
    *  SOAP actor roles are invariant during the processing of
    *  SOAP message through the handler chain.
    *
-   *  @return Array of <code>String</code> for SOAP actor roles
+   *  @return Array of {@code String} for SOAP actor roles
   **/
   public Set<String> getRoles();
 }