public class MimeHeaders extends Object
MimeHeader objects, which represent
 the MIME headers present in a MIME part of a message.
 This class is used primarily when an application wants to
 retrieve specific attachments based on certain MIME headers and
 values. This class will most likely be used by implementations of
 AttachmentPart and other MIME dependent parts of the SAAJ
 API.
SOAPMessage.getAttachments(), 
AttachmentPart| Constructor and Description | 
|---|
| MimeHeaders()Constructs a default  MimeHeadersobject initialized with
 an emptyVectorobject. | 
| Modifier and Type | Method and Description | 
|---|---|
| void | addHeader(String name,
         String value)Adds a  MimeHeaderobject with the specified name and value
 to thisMimeHeadersobject's list of headers. | 
| Iterator | getAllHeaders()Returns all the  MimeHeaders in thisMimeHeadersobject. | 
| String[] | getHeader(String name)Returns all of the values for the specified header as an array of
  Stringobjects. | 
| Iterator | getMatchingHeaders(String[] names)Returns all the  MimeHeaderobjects whose name matches
 a name in the given array of names. | 
| Iterator | getNonMatchingHeaders(String[] names)Returns all of the  MimeHeaderobjects whose name does not
 match a name in the given array of names. | 
| void | removeAllHeaders()Removes all the header entries from this  MimeHeadersobject. | 
| void | removeHeader(String name)Remove all  MimeHeaderobjects whose name matches the
 given name. | 
| void | setHeader(String name,
         String value)Replaces the current value of the first header entry whose name matches
 the given name with the given value, adding a new header if no existing header
 name matches. | 
public MimeHeaders()
MimeHeaders object initialized with
 an empty Vector object.public String[] getHeader(String name)
String objects.name - the name of the header for which values will be returnedString array with all of the values for the
         specified headersetHeader(java.lang.String, java.lang.String)public void setHeader(String name, String value)
Note that RFC822 headers can contain only US-ASCII characters.
name - a String with the name of the header for
          which to searchvalue - a String with the value that will replace the
          current value of the specified headerIllegalArgumentException - if there was a problem in the
 mime header name or the value being setgetHeader(java.lang.String)public void addHeader(String name, String value)
MimeHeader object with the specified name and value
 to this MimeHeaders object's list of headers.
 Note that RFC822 headers can contain only US-ASCII characters.
name - a String with the name of the header to
          be addedvalue - a String with the value of the header to
          be addedIllegalArgumentException - if there was a problem in the
 mime header name or value being addedpublic void removeHeader(String name)
MimeHeader objects whose name matches the
 given name.name - a String with the name of the header for
          which to searchpublic void removeAllHeaders()
MimeHeaders object.public Iterator getAllHeaders()
MimeHeaders in this MimeHeaders object.Iterator object over this MimeHeaders
          object's list of MimeHeader objectspublic Iterator getMatchingHeaders(String[] names)
MimeHeader objects whose name matches
 a name in the given array of names.names - an array of String objects with the names
         for which to searchIterator object over the MimeHeader
          objects whose name matches one of the names in the given listpublic Iterator getNonMatchingHeaders(String[] names)
MimeHeader objects whose name does not
 match a name in the given array of names.names - an array of String objects with the names
         for which to searchIterator object over the MimeHeader
          objects whose name does not match one of the names in the given list Submit a bug or feature 
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
 Copyright © 1993, 2025, Oracle and/or its affiliates.  All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.