public interface MimePart extends Part
The string representation of RFC822 and MIME header fields must contain
only US-ASCII characters. Non US-ASCII characters must be encoded as per
the rules in RFC 2047. This class does not enforce those rules; the
caller is expected to use MimeUtility to ensure that header
values are correctly encoded.
ATTACHMENT, INLINE | Modifier and Type | Method and Description |
|---|---|
void |
addHeaderLine (java.lang.String line)
Adds an RFC822 header-line.
|
java.util.Enumeration |
getAllHeaderLines ()
Returns all the header-lines.
|
java.lang.String |
getContentID ()
Returns the value of the Content-ID header field of this part.
|
java.lang.String[] |
getContentLanguage ()
Returns the languages specified in the Content-Language header of this
part, as defined by RFC 1766.
|
java.lang.String |
getContentMD5 ()
Returns the value of the Content-MD5 header field of this part.
|
java.lang.String |
getEncoding ()
Returns the value of the Content-Transfer-Encoding header field of
this part.
|
java.lang.String |
getHeader (java.lang.String header_name,
java.lang.String delimiter)
Returns the values of all header fields for the specified name,
returned as a single String with the values separated by the given
delimiter.
|
java.util.Enumeration |
getMatchingHeaderLines (java.lang.String[] names)
Returns all the header-lines with any of the given names.
|
java.util.Enumeration |
getNonMatchingHeaderLines (java.lang.String[] names)
Returns all the header-lines without any of the given names.
|
void |
setContentLanguage (java.lang.String[] languages)
Sets the Content-Language header of this part.
|
void |
setContentMD5 (java.lang.String md5)
Sets the Content-MD5 header value for this part.
|
void |
setText (java.lang.String text)
Sets the content of this message using the specified text, and with a
MIME type of "text/plain".
|
void |
setText (java.lang.String text,
java.lang.String charset)
Sets the content of this message using the specified text, and with a
MIME type of "text/plain".
|
void |
setText (java.lang.String text,
java.lang.String charset,
java.lang.String subtype)
Sets the content of this message using the specified text, and with a
text MIME type of the specified subtype.
|
addHeader, getAllHeaders, getContent, getContentType, getDataHandler, getDescription, getDisposition, getFileName, getHeader, getInputStream, getLineCount, getMatchingHeaders, getNonMatchingHeaders, getSize, isMimeType, removeHeader, setContent, setContent, setDataHandler, setDescription, setDisposition, setFileName, setHeader, writeTo java.lang.String getHeader(java.lang.String header_name, java.lang.String delimiter) throws MessagingException
header_name - the header nameMessagingException void addHeaderLine(java.lang.String line) throws MessagingException
IllegalWriteException - if the underlying implementation does not
support modificationjava.lang.IllegalStateException - if this part is obtained from a READ_ONLY
folderMessagingException java.util.Enumeration getAllHeaderLines() throws MessagingException
MessagingException java.util.Enumeration getMatchingHeaderLines(java.lang.String[] names) throws MessagingException
MessagingException java.util.Enumeration getNonMatchingHeaderLines(java.lang.String[] names) throws MessagingException
MessagingException java.lang.String getEncoding() throws MessagingException
MessagingException java.lang.String getContentID() throws MessagingException
MessagingException java.lang.String getContentMD5() throws MessagingException
MessagingException void setContentMD5(java.lang.String md5) throws MessagingException
IllegalStateException - if this part is obtained from a READ_ONLY
folderIllegalWriteException - if the underlying implementation does not
support modificationMessagingException java.lang.String[] getContentLanguage() throws MessagingException
null if
this header is not available.MessagingException void setContentLanguage(java.lang.String[] languages) throws MessagingException
languages - the array of language tagsIllegalWriteException - if the underlying implementation does not
support modificationjava.lang.IllegalStateException - if this Part is obtained from a READ_ONLY
folderMessagingException void setText(java.lang.String text) throws MessagingException
If the string contains non US-ASCII characters, it will be encoded using the platform default charset.
setText in interface Part text - the text contentIllegalWriteException - if the underlying implementation
does not support modificationMessagingException void setText(java.lang.String text, java.lang.String charset) throws MessagingException
If the string contains non US-ASCII characters, it will be encoded using the specified charset.
text - the text contentcharset - the charset to use for any encodingMessagingException void setText(java.lang.String text, java.lang.String charset, java.lang.String subtype) throws MessagingException
If the string contains non US-ASCII characters, it will be encoded using the specified charset.
text - the text contentcharset - the charset to use for any encodingsubtype - the MIME text subtype (e.g. "plain", "html")MessagingException