jaxws/src/java.xml.ws/share/classes/javax/xml/soap/SOAPMessage.java

*** 1,7 ****
  /*
!  * Copyright (c) 2004, 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
--- 1,7 ----
  /*
!  * Copyright (c) 2004, 2017, 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
*** 203,213 ****
       * 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} objects that have header
       * entries that match the specified headers. Note that a returned
       * attachment could have headers in addition to those specified.
--- 203,213 ----
       * 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<AttachmentPart> getAttachments();
  
      /**
       * 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.
*** 215,225 ****
       * @param headers a {@code MimeHeaders} object containing the MIME
       *                headers for which to search
       * @return an iterator over all attachments that have a header that matches
       * one of the given headers
       */
!     public abstract Iterator getAttachments(MimeHeaders headers);
  
      /**
       * Removes all the {@code AttachmentPart} objects that have header
       * entries that match the specified headers. Note that the removed
       * attachment could have headers in addition to those specified.
--- 215,225 ----
       * @param headers a {@code MimeHeaders} object containing the MIME
       *                headers for which to search
       * @return an iterator over all attachments that have a header that matches
       * one of the given headers
       */
!     public abstract Iterator<AttachmentPart> getAttachments(MimeHeaders headers);
  
      /**
       * Removes all the {@code AttachmentPart} objects that have header
       * entries that match the specified headers. Note that the removed
       * attachment could have headers in addition to those specified.
*** 264,279 ****
      /**
       * 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} object that is to become part
       *           of this {@code SOAPMessage} object
       * @exception IllegalArgumentException
       */
!     public abstract void addAttachmentPart(AttachmentPart AttachmentPart);
  
      /**
       * 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
--- 264,281 ----
      /**
       * 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} object that is to become part
       *           of this {@code SOAPMessage} object
       * @exception IllegalArgumentException
+      *               if there was a problem with the specified {@code attachmentPart}
+      *               object
       */
!     public abstract void addAttachmentPart(AttachmentPart attachmentPart);
  
      /**
       * 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