A container for MimeHeader objects, which represent
the MIME headers present in a MIME part of a message.
A container for 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.
Adds a MimeHeader object with the specified name and value
to this MimeHeaders object's list of headers.
Adds a 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.
Parameters: - name - a String with the name of the header to
be added
- value - a String with the value of the header to
be added
Throws: - IllegalArgumentException - if there was a problem in the
mime header name or value being added
Returns all of the values for the specified header as an array of
String objects.
Returns all of the values for the specified header as an array of String objects.
Returns:
a String array with all of the values for the
specified header
Parameters: - name - the name of the header for which values will be returned
See Also:MimeHeaders.setHeader(java.lang.String, java.lang.String),
Returns all the MimeHeader objects whose name matches
a name in the given array of names.
Returns all the MimeHeader objects whose name matches a name in the given array of names.
Returns:
an Iterator object over the MimeHeader
objects whose name matches one of the names in the given list
Parameters: - names - an array of String objects with the names
for which to search
Returns all of the MimeHeader objects whose name does not
match a name in the given array of names.
Returns all of the MimeHeader objects whose name does not match a name in the given array of names.
Returns:
an Iterator object over the MimeHeader
objects whose name does not match one of the names in the given list
Parameters: - names - an array of String objects with the names
for which to search
public void
removeAllHeaders
()
Removes all the header entries from this MimeHeaders object.
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.
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. This method also removes all matching headers after the first one.
Note that RFC822 headers can contain only US-ASCII characters.
Parameters: - name - a String with the name of the header for
which to search
- value - a String with the value that will replace the
current value of the specified header
Throws: - IllegalArgumentException - if there was a problem in the
mime header name or the value being set
See Also:MimeHeaders.getHeader(java.lang.String),