public class POP3Message extends MimeMessage implements ReadableMime
Constructor and Description |
---|
POP3Message(Folder folder,
int msgno) |
Modifier and Type | Method and Description |
---|---|
void |
addHeader(java.lang.String name,
java.lang.String value)
Add this value to the existing values for this header_name.
|
void |
addHeaderLine(java.lang.String line)
Add a raw RFC822 header-line.
|
java.util.Enumeration |
getAllHeaderLines()
Get all header lines as an Enumeration of Strings.
|
java.util.Enumeration |
getAllHeaders()
Return all the headers from this Message as an enumeration
of Header objects.
|
java.lang.String[] |
getHeader(java.lang.String name)
Get all the headers for this header_name.
|
java.lang.String |
getHeader(java.lang.String name,
java.lang.String delimiter)
Get all the headers for this header name, returned as a single
String, with headers separated by the delimiter.
|
java.util.Enumeration |
getMatchingHeaderLines(java.lang.String[] names)
Get matching header lines as an Enumeration of Strings.
|
java.util.Enumeration |
getMatchingHeaders(java.lang.String[] names)
Return matching headers from this Message as an Enumeration of
Header objects.
|
java.io.InputStream |
getMimeStream()
Return the MIME format stream corresponding to this message part.
|
java.util.Enumeration |
getNonMatchingHeaderLines(java.lang.String[] names)
Get non-matching header lines as an Enumeration of Strings.
|
java.util.Enumeration |
getNonMatchingHeaders(java.lang.String[] names)
Return non-matching headers from this Message as an
Enumeration of Header objects.
|
int |
getSize()
Return the size of the content of this message in bytes.
|
void |
invalidate(boolean invalidateHeaders)
Invalidate the cache of content for this message object, causing
it to be fetched again from the server the next time it is needed.
|
void |
removeHeader(java.lang.String name)
Remove all headers with this name.
|
void |
saveChanges()
POP3 message can't be changed.
|
void |
setFlags(Flags newFlags,
boolean set)
Set the specified flags on this message to the specified value.
|
void |
setHeader(java.lang.String name,
java.lang.String value)
Set the value for this header_name.
|
java.io.InputStream |
top(int n)
Fetch the header of the message and the first
n lines
of the raw content of the message. |
void |
writeTo(java.io.OutputStream os,
java.lang.String[] ignoreList)
Output the message as an RFC 822 format stream, without
specified headers.
|
public POP3Message(Folder folder, int msgno) throws MessagingException
MessagingException
public void setFlags(Flags newFlags, boolean set) throws MessagingException
newFlags
- the flags to be setset
- the value to be setMessagingException
public int getSize() throws MessagingException
Note that this number may not be an exact measure of the content size and may or may not account for any transfer encoding of the content.
MessagingException
public java.io.InputStream getMimeStream() throws MessagingException
getMimeStream
in interface ReadableMime
MessagingException
public void invalidate(boolean invalidateHeaders)
invalidateHeaders
is true, invalidate the headers
as well.invalidateHeaders
- invalidate the headers as well?public java.io.InputStream top(int n) throws MessagingException
n
lines
of the raw content of the message. The headers and data are
available in the returned InputStream.n
- number of lines of content to fetchMessagingException
public java.lang.String[] getHeader(java.lang.String name) throws MessagingException
name
- name of headerMessagingException
javax.mail.internet.MimeUtility
public java.lang.String getHeader(java.lang.String name, java.lang.String delimiter) throws MessagingException
null
, only the first header is
returned.name
- the name of this headerdelimiter
- delimiter between returned headersMessagingException
public void setHeader(java.lang.String name, java.lang.String value) throws MessagingException
name
- header namevalue
- header valueIllegalWriteException
- because the underlying
implementation does not support modificationjava.lang.IllegalStateException
- if this message is
obtained from a READ_ONLY folder.MessagingException
javax.mail.internet.MimeUtility
public void addHeader(java.lang.String name, java.lang.String value) throws MessagingException
name
- header namevalue
- header valueIllegalWriteException
- because the underlying
implementation does not support modificationjava.lang.IllegalStateException
- if this message is
obtained from a READ_ONLY folder.MessagingException
javax.mail.internet.MimeUtility
public void removeHeader(java.lang.String name) throws MessagingException
IllegalWriteException
- because the underlying
implementation does not support modificationjava.lang.IllegalStateException
- if this message is
obtained from a READ_ONLY folder.MessagingException
public java.util.Enumeration getAllHeaders() throws MessagingException
Note that certain headers may be encoded as per RFC 2047 if they contain non US-ASCII characters and these should be decoded.
MessagingException
javax.mail.internet.MimeUtility
public java.util.Enumeration getMatchingHeaders(java.lang.String[] names) throws MessagingException
MessagingException
public java.util.Enumeration getNonMatchingHeaders(java.lang.String[] names) throws MessagingException
MessagingException
public void addHeaderLine(java.lang.String line) throws MessagingException
IllegalWriteException
- because the underlying
implementation does not support modificationjava.lang.IllegalStateException
- if this message is
obtained from a READ_ONLY folder.MessagingException
public java.util.Enumeration getAllHeaderLines() throws MessagingException
MessagingException
public java.util.Enumeration getMatchingHeaderLines(java.lang.String[] names) throws MessagingException
MessagingException
public java.util.Enumeration getNonMatchingHeaderLines(java.lang.String[] names) throws MessagingException
MessagingException
public void saveChanges() throws MessagingException
IllegalWriteException
- because the underlying
implementation does not support modificationMessagingException
public void writeTo(java.io.OutputStream os, java.lang.String[] ignoreList) throws java.io.IOException, MessagingException
javax.mail.MessagingException
java.io.IOException
- if an error occurs writing to the stream
or if an error is generated by the
javax.activation layer.MessagingException
DataHandler.writeTo(java.io.OutputStream)
"Copyright © 2010 - 2020 Adobe Systems Incorporated. All Rights Reserved"