src/java.xml.ws/share/classes/javax/xml/ws/soap/SOAPBinding.java

*** 29,39 ****
  import java.util.Set;
  import javax.xml.ws.Binding;
  import javax.xml.soap.SOAPFactory;
  import javax.xml.soap.MessageFactory;
  
! /** The <code>SOAPBinding</code> interface is an abstraction for
   *  the SOAP binding.
   *
   *  @since 1.6, JAX-WS 2.0
  **/
  public interface SOAPBinding extends Binding {
--- 29,39 ----
  import java.util.Set;
  import javax.xml.ws.Binding;
  import javax.xml.soap.SOAPFactory;
  import javax.xml.soap.MessageFactory;
  
! /** The {@code SOAPBinding} interface is an abstraction for
   *  the SOAP binding.
   *
   *  @since 1.6, JAX-WS 2.0
  **/
  public interface SOAPBinding extends Binding {
*** 61,71 ****
    public static final String SOAP12HTTP_MTOM_BINDING = "http://www.w3.org/2003/05/soap/bindings/HTTP/?mtom=true";
  
  
    /** Gets the roles played by the SOAP binding instance.
     *
!    *  @return Set&lt;String> The set of roles played by the binding instance.
    **/
    public Set<String> getRoles();
  
    /** Sets the roles played by the SOAP binding instance.
     *
--- 61,71 ----
    public static final String SOAP12HTTP_MTOM_BINDING = "http://www.w3.org/2003/05/soap/bindings/HTTP/?mtom=true";
  
  
    /** Gets the roles played by the SOAP binding instance.
     *
!    *  @return {@code Set<String>} The set of roles played by the binding instance.
    **/
    public Set<String> getRoles();
  
    /** Sets the roles played by the SOAP binding instance.
     *
*** 74,110 ****
     *                  the list of roles.
    **/
    public void setRoles(Set<String> roles);
  
    /**
!    * Returns <code>true</code> if the use of MTOM is enabled.
     *
!    * @return <code>true</code> if and only if the use of MTOM is enabled.
    **/
  
    public boolean isMTOMEnabled();
  
    /**
     * Enables or disables use of MTOM.
     *
!    * @param flag   A <code>boolean</code> specifying whether the use of MTOM should
     *               be enabled or disabled.
     * @throws WebServiceException If the specified setting is not supported
     *                  by this binding instance.
     *
     **/
    public void setMTOMEnabled(boolean flag);
  
    /**
!    * Gets the SAAJ <code>SOAPFactory</code> instance used by this SOAP binding.
     *
     * @return SOAPFactory instance used by this SOAP binding.
    **/
    public SOAPFactory getSOAPFactory();
  
    /**
!    * Gets the SAAJ <code>MessageFactory</code> instance used by this SOAP binding.
     *
     * @return MessageFactory instance used by this SOAP binding.
    **/
    public MessageFactory getMessageFactory();
  }
--- 74,110 ----
     *                  the list of roles.
    **/
    public void setRoles(Set<String> roles);
  
    /**
!    * Returns {@code true} if the use of MTOM is enabled.
     *
!    * @return {@code true} if and only if the use of MTOM is enabled.
    **/
  
    public boolean isMTOMEnabled();
  
    /**
     * Enables or disables use of MTOM.
     *
!    * @param flag   A {@code boolean} specifying whether the use of MTOM should
     *               be enabled or disabled.
     * @throws WebServiceException If the specified setting is not supported
     *                  by this binding instance.
     *
     **/
    public void setMTOMEnabled(boolean flag);
  
    /**
!    * Gets the SAAJ {@code SOAPFactory} instance used by this SOAP binding.
     *
     * @return SOAPFactory instance used by this SOAP binding.
    **/
    public SOAPFactory getSOAPFactory();
  
    /**
!    * Gets the SAAJ {@code MessageFactory} instance used by this SOAP binding.
     *
     * @return MessageFactory instance used by this SOAP binding.
    **/
    public MessageFactory getMessageFactory();
  }