| javax.mail.internet.MimePart
All known Subclasses: javax.mail.internet.MimeMessage, javax.mail.internet.MimeBodyPart,
| MimePart | | public interface MimePart extends Part(Code) | | The MimePart interface models an Entity as defined
by MIME (RFC2045, Section 2.4).
MimePart extends the Part interface to add additional RFC822 and MIME
specific semantics and attributes. It provides the base interface for
the MimeMessage and MimeBodyPart classes
A note on RFC822 and MIME headers
RFC822 and MIME header fields must contain only
US-ASCII characters. If a header contains non US-ASCII characters,
it must be encoded as per the rules in RFC 2047. The MimeUtility
class provided in this package can be used to to achieve this.
Callers of the setHeader, addHeader, and
addHeaderLine methods are responsible for enforcing
the MIME requirements for the specified headers. In addition, these
header fields must be folded (wrapped) before being sent if they
exceed the line length limitation for the transport (1000 bytes for
SMTP). Received headers may have been folded. The application is
responsible for folding and unfolding headers as appropriate.
See Also: MimeUtility
See Also: javax.mail.Part
author:
John Mani |
| getAllHeaderLines | | public Enumeration getAllHeaderLines() throws MessagingException(Code) | | Get all header lines as an Enumeration of Strings. A Header
line is a raw RFC822 header-line, containing both the "name"
and "value" field.
|
| getContentLanguage | | public String[] getContentLanguage() throws MessagingException(Code) | | Get the language tags specified in the Content-Language header
of this MimePart. The Content-Language header is defined by
RFC 1766. Returns null if this header is not
available.
|
| getContentMD5 | | public String getContentMD5() throws MessagingException(Code) | | Get the Content-MD5 digest of this part. Returns null if
none present.
content-MD5 |
| getHeader | | public String getHeader(String name, String delimiter) throws MessagingException(Code) | | Get the values of all header fields available for this header,
returned as a single String, with the values separated by the
delimiter. If the delimiter is null, only the
first value is returned.
Parameters:
name - the name of this header
Parameters:
delimiter - delimiter between fields in returned string the value fields for all headers with this name
exception:
MessagingException - |
| getMatchingHeaderLines | | public Enumeration getMatchingHeaderLines(String[] names) throws MessagingException(Code) | | Get matching header lines as an Enumeration of Strings.
A Header line is a raw RFC822 header-line, containing both
the "name" and "value" field.
|
| getNonMatchingHeaderLines | | public Enumeration getNonMatchingHeaderLines(String[] names) throws MessagingException(Code) | | Get non-matching header lines as an Enumeration of Strings.
A Header line is a raw RFC822 header-line, containing both
the "name" and "value" field.
|
| setContentLanguage | | public void setContentLanguage(String[] languages) throws MessagingException(Code) | | Set the Content-Language header of this MimePart. The
Content-Language header is defined by RFC1766.
Parameters:
languages - array of language tags
exception:
IllegalWriteException - if the underlyingimplementation does not support modification
exception:
IllegalStateException - if this Part isobtained from a READ_ONLY folder |
| setText | | public void setText(String text) throws MessagingException(Code) | | Convenience method that sets the given String as this
part's content, with a MIME type of "text/plain". If the
string contains non US-ASCII characters. it will be encoded
using the platform's default charset. The charset is also
used to set the "charset" parameter.
Note that there may be a performance penalty if
text is large, since this method may have
to scan all the characters to determine what charset to
use.
If the charset is already known, use the
setText method that takes the charset parameter.
Parameters:
text - the text content to set
exception:
MessagingException - if an error occurs
See Also: MimePart.setText(String text,String charset) |
| setText | | public void setText(String text, String charset) throws MessagingException(Code) | | Convenience method that sets the given String as this part's
content, with a MIME type of "text/plain" and the specified
charset. The given Unicode string will be charset-encoded
using the specified charset. The charset is also used to set
"charset" parameter.
Parameters:
text - the text content to set
Parameters:
charset - the charset to use for the text
exception:
MessagingException - if an error occurs |
| setText | | public void setText(String text, String charset, String subtype) throws MessagingException(Code) | | Convenience method that sets the given String as this part's
content, with a primary MIME type of "text" and the specified
MIME subtype. The given Unicode string will be charset-encoded
using the specified charset. The charset is also used to set
the "charset" parameter.
Parameters:
text - the text content to set
Parameters:
charset - the charset to use for the text
Parameters:
subtype - the MIME subtype to use (e.g., "html")
exception:
MessagingException - if an error occurs
since:
JavaMail 1.4 |
|
|