|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface MimePart
A MIME part is an Entity as defined by MIME (RFC2045, Section 2.4).
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.
Field Summary |
---|
Fields inherited from interface javax.mail.Part |
---|
ATTACHMENT, INLINE |
Method Summary | |
---|---|
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. |
Methods inherited from interface javax.mail.Part |
---|
addHeader, getAllHeaders, getContent, getContentType, getDataHandler, getDescription, getDisposition, getFileName, getHeader, getInputStream, getLineCount, getMatchingHeaders, getNonMatchingHeaders, getSize, isMimeType, removeHeader, setContent, setContent, setDataHandler, setDescription, setDisposition, setFileName, setHeader, writeTo |
Method Detail |
---|
String getHeader(String header_name, String delimiter) throws MessagingException
header_name
- the header name
MessagingException
void addHeaderLine(String line) throws MessagingException
IllegalWriteException
- if the underlying implementation does not
support modification
IllegalStateException
- if this part is obtained from a READ_ONLY
folder
MessagingException
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
folder
IllegalWriteException
- if the underlying implementation does not
support modification
MessagingException
String[] getContentLanguage() throws MessagingException
null
if
this header is not available.
MessagingException
void setContentLanguage(String[] languages) throws MessagingException
languages
- the array of language tags
IllegalWriteException
- if the underlying implementation does not
support modification
IllegalStateException
- if this Part is obtained from a READ_ONLY
folder
MessagingException
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 content
IllegalWriteException
- if the underlying implementation
does not support modification
MessagingException
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 encoding
MessagingException
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
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |