javax.mail.internet
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(String line)
Adds an RFC822 header-line.
|
Enumeration |
getAllHeaderLines()
Returns all the header-lines.
|
String |
getContentID()
Returns the value of the Content-ID header field of this part.
|
String[] |
getContentLanguage()
Returns the languages specified in the Content-Language header of this
part, as defined by RFC 1766.
|
String |
getContentMD5()
Returns the value of the Content-MD5 header field of this part.
|
String |
getEncoding()
Returns the value of the Content-Transfer-Encoding header field of
this part.
|
String |
getHeader(String header_name,
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.
|
Enumeration |
getMatchingHeaderLines(String[] names)
Returns all the header-lines with any of the given names.
|
Enumeration |
getNonMatchingHeaderLines(String[] names)
Returns all the header-lines without any of the given names.
|
void |
setContentLanguage(String[] languages)
Sets the Content-Language header of this part.
|
void |
setContentMD5(String md5)
Sets the Content-MD5 header value for this part.
|
void |
setText(String text)
Sets the content of this message using the specified text, and with a
MIME type of "text/plain".
|
void |
setText(String text,
String charset)
Sets the content of this message using the specified text, and with a
MIME type of "text/plain".
|
void |
setText(String text,
String charset,
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
String getHeader(String header_name, String delimiter) throws MessagingException
header_name
- the header nameMessagingException
void addHeaderLine(String line) throws MessagingException
IllegalWriteException
- if the underlying implementation does not
support modificationIllegalStateException
- if this part is obtained from a READ_ONLY
folderMessagingException
Enumeration getAllHeaderLines() throws MessagingException
MessagingException
Enumeration getMatchingHeaderLines(String[] names) throws MessagingException
MessagingException
Enumeration getNonMatchingHeaderLines(String[] names) throws MessagingException
MessagingException
String getEncoding() throws MessagingException
MessagingException
String getContentID() throws MessagingException
MessagingException
String getContentMD5() throws MessagingException
MessagingException
void setContentMD5(String md5) throws MessagingException
IllegalStateException
- if this part is obtained from a READ_ONLY
folderIllegalWriteException
- if the underlying implementation does not
support modificationMessagingException
String[] getContentLanguage() throws MessagingException
null
if
this header is not available.MessagingException
void setContentLanguage(String[] languages) throws MessagingException
languages
- the array of language tagsIllegalWriteException
- if the underlying implementation does not
support modificationIllegalStateException
- if this Part is obtained from a READ_ONLY
folderMessagingException
void setText(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(String text, 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(String text, String charset, 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
© Copyright 2003, 2004 The Free Software Foundation, All rights reserved