com.sun.mail.pop3
Class POP3Message

java.lang.Object
  |
  +--javax.mail.Message
        |
        +--javax.mail.internet.MimeMessage
              |
              +--com.sun.mail.pop3.POP3Message

All Implemented Interfaces:

MimePart, Part

public class POP3Message

extends MimeMessage

A POP3 Message. Just like a MimeMessage except that some things are not supported.

Inner classes inherited from class javax.mail.internet.MimeMessage

MimeMessage.RecipientType

Inner classes inherited from class javax.mail.Message

Message.RecipientType

Fields inherited from class javax.mail.internet.MimeMessage

content, contentStream, dh, flags, headers, modified, saved

Fields inherited from class javax.mail.Message

expunged, folder, msgnum, session

Fields inherited from interface javax.mail.Part

ATTACHMENT, INLINE

Constructor Summary

POP3Message(Folder folder, int msgno)

Method Summary

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.
protected java.io.InputStream	getContentStream() Produce the raw bytes of the content.
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.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.

Methods inherited from class javax.mail.internet.MimeMessage

addFrom, addRecipients, addRecipients, createInternetHeaders, getAllRecipients, getContent, getContentID, getContentLanguage, getContentMD5, getContentType, getDataHandler, getDescription, getDisposition, getEncoding, getFileName, getFlags, getFrom, getInputStream, getLineCount, getMessageID, getRawInputStream, getReceivedDate, getRecipients, getReplyTo, getSender, getSentDate, getSubject, isMimeType, isSet, parse, reply, setContent, setContent, setContentID, setContentLanguage, setContentMD5, setDataHandler, setDescription, setDescription, setDisposition, setFileName, setFrom, setFrom, setRecipients, setRecipients, setReplyTo, setSender, setSentDate, setSubject, setSubject, setText, setText, updateHeaders, writeTo, writeTo

Methods inherited from class javax.mail.Message

addRecipient, getFolder, getMessageNumber, isExpunged, match, setExpunged, setFlag, setMessageNumber, setRecipient

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

POP3Message

public POP3Message(Folder folder,
                   int msgno)
            throws MessagingException

Method Detail

setFlags

public void setFlags(Flags newFlags,
                     boolean set)
              throws MessagingException

Set the specified flags on this message to the specified value.

Overrides:

setFlags in class MimeMessage

Parameters:

newFlags - the flags to be set

set - the value to be set

getSize

public int getSize()
            throws MessagingException

Return the size of the content of this message in bytes. Returns -1 if the size cannot be determined.

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.

Overrides:

getSize in class MimeMessage

Returns:

size of content in bytes

Throws:

MessagingException -

getContentStream

protected java.io.InputStream getContentStream()
                                        throws MessagingException

Produce the raw bytes of the content. The data is fetched using the POP3 RETR command.

Overrides:

getContentStream in class MimeMessage

See Also:

MimeMessage.contentStream

invalidate

public 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. If invalidateHeaders is true, invalidate the headers as well.

Parameters:

invalidateHeaders - invalidate the headers as well?

top

public java.io.InputStream top(int n)
                        throws MessagingException

Fetch the header of the message and the first n lines of the raw content of the message. The headers and data are available in the returned InputStream.

Parameters:

n - number of lines of content to fetch

Returns:

InputStream containing the message headers and n content lines

getHeader

public java.lang.String[] getHeader(java.lang.String name)
                             throws MessagingException

Get all the headers for this header_name. Note that certain headers may be encoded as per RFC 2047 if they contain non US-ASCII characters and these should be decoded.

Overrides:

getHeader in class MimeMessage

Parameters:

name - name of header

Returns:

array of headers

Throws:

MessagingException -

See Also:

MimeUtility

getHeader

public java.lang.String getHeader(java.lang.String name,
                                  java.lang.String delimiter)
                           throws MessagingException

Get all the headers for this header name, returned as a single String, with headers separated by the delimiter. If the delimiter is null, only the first header is returned.

Overrides:

getHeader in class MimeMessage

Parameters:

header_name - the name of this header

Returns:

the value fields for all headers with this name

Throws:

MessagingException -

setHeader

public void setHeader(java.lang.String name,
                      java.lang.String value)
               throws MessagingException

Set the value for this header_name. Throws IllegalWriteException because POP3 messages are read-only.

Overrides:

setHeader in class MimeMessage

Parameters:

name - header name

value - header value

Throws:

IllegalWriteException - because the underlying implementation does not support modification

IllegalStateException - if this message is obtained from a READ_ONLY folder.

See Also:

MimeUtility

addHeader

public void addHeader(java.lang.String name,
                      java.lang.String value)
               throws MessagingException

Add this value to the existing values for this header_name. Throws IllegalWriteException because POP3 messages are read-only.

Overrides:

addHeader in class MimeMessage

Parameters:

name - header name

value - header value

Throws:

IllegalWriteException - because the underlying implementation does not support modification

IllegalStateException - if this message is obtained from a READ_ONLY folder.

See Also:

MimeUtility

removeHeader

public void removeHeader(java.lang.String name)
                  throws MessagingException

Remove all headers with this name. Throws IllegalWriteException because POP3 messages are read-only.

Overrides:

removeHeader in class MimeMessage

Throws:

IllegalWriteException - because the underlying implementation does not support modification

IllegalStateException - if this message is obtained from a READ_ONLY folder.

getAllHeaders

public java.util.Enumeration getAllHeaders()
                                    throws MessagingException

Return all the headers from this Message as an enumeration of Header objects.

Note that certain headers may be encoded as per RFC 2047 if they contain non US-ASCII characters and these should be decoded.

Overrides:

getAllHeaders in class MimeMessage

Returns:

array of header objects

Throws:

MessagingException -

See Also:

MimeUtility

getMatchingHeaders

public java.util.Enumeration getMatchingHeaders(java.lang.String[] names)
                                         throws MessagingException

Return matching headers from this Message as an Enumeration of Header objects.

Overrides:

getMatchingHeaders in class MimeMessage

Throws:

MessagingException -

getNonMatchingHeaders

public java.util.Enumeration getNonMatchingHeaders(java.lang.String[] names)
                                            throws MessagingException

Return non-matching headers from this Message as an Enumeration of Header objects.

Overrides:

getNonMatchingHeaders in class MimeMessage

Throws:

MessagingException -

addHeaderLine

public void addHeaderLine(java.lang.String line)
                   throws MessagingException

Add a raw RFC822 header-line. Throws IllegalWriteException because POP3 messages are read-only.

Overrides:

addHeaderLine in class MimeMessage

Throws:

IllegalWriteException - because the underlying implementation does not support modification

IllegalStateException - if this message is obtained from a READ_ONLY folder.

getAllHeaderLines

public java.util.Enumeration getAllHeaderLines()
                                        throws MessagingException

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.

Overrides:

getAllHeaderLines in class MimeMessage

Throws:

MessagingException -

getMatchingHeaderLines

public java.util.Enumeration getMatchingHeaderLines(java.lang.String[] names)
                                             throws MessagingException

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.

Overrides:

getMatchingHeaderLines in class MimeMessage

Throws:

MessagingException -

getNonMatchingHeaderLines

public java.util.Enumeration getNonMatchingHeaderLines(java.lang.String[] names)
                                                throws MessagingException

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.

Overrides:

getNonMatchingHeaderLines in class MimeMessage

Throws:

MessagingException -

saveChanges

public void saveChanges()
                 throws MessagingException

POP3 message can't be changed. This method throws IllegalWriteException.

Overrides:

saveChanges in class MimeMessage

Throws:

IllegalWriteException - because the underlying implementation does not support modification