Package com.sun.mail.imap

Class IMAPMessage

java.lang.Object

javax.mail.Message

javax.mail.internet.MimeMessage

com.sun.mail.imap.IMAPMessage

All Implemented Interfaces:

com.sun.mail.util.ReadableMime, javax.mail.internet.MimePart, javax.mail.Part

Direct Known Subclasses:

IMAPNestedMessage

public class IMAPMessage
extends javax.mail.internet.MimeMessage
implements com.sun.mail.util.ReadableMime

This class implements an IMAPMessage object.

An IMAPMessage object starts out as a light-weight object. It gets filled-in incrementally when a request is made for some item. Or when a prefetch is done using the FetchProfile.

An IMAPMessage has a messageNumber and a sequenceNumber. The messageNumber is its index into its containing folder's messageCache. The sequenceNumber is its IMAP sequence-number.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	IMAPMessage.FetchProfileCondition	This class implements the test to be done on each message in the folder.

Nested classes/interfaces inherited from class javax.mail.internet.MimeMessage

javax.mail.internet.MimeMessage.RecipientType

Field Summary

Fields

Modifier and Type	Field	Description
protected com.sun.mail.imap.protocol.BODYSTRUCTURE	bs
protected com.sun.mail.imap.protocol.ENVELOPE	envelope
protected java.util.Map<java.lang.String,java.lang.Object>	items	A map of the extension FETCH items.
protected java.lang.String	sectionId

Fields inherited from class javax.mail.internet.MimeMessage

cachedContent, 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

Constructors

Modifier	Constructor	Description
protected	IMAPMessage(IMAPFolder folder, int msgnum)	Constructor.
protected	IMAPMessage(javax.mail.Session session)	Constructor, for use by IMAPNestedMessage.

Method Summary

Modifier and Type	Method	Description
void	addFrom(javax.mail.Address[] addresses)
void	addHeader(java.lang.String name, java.lang.String value)
void	addHeaderLine(java.lang.String line)
void	addRecipients(javax.mail.Message.RecipientType type, javax.mail.Address[] addresses)
protected void	checkExpunged()
protected java.lang.Object	fetchItem(com.sun.mail.imap.protocol.FetchItem fitem)	Fetch an individual item for the current message.
protected void	forceCheckExpunged()	Do a NOOP to force any untagged EXPUNGE responses and then check if this message is expunged.
java.util.Enumeration<java.lang.String>	getAllHeaderLines()	Get all header-lines.
java.util.Enumeration<javax.mail.Header>	getAllHeaders()	Get all headers.
java.lang.String	getContentID()	Get the Content-ID.
java.lang.String[]	getContentLanguage()	Get the content language.
java.lang.String	getContentMD5()	Get the Content-MD5.
protected java.io.InputStream	getContentStream()	Get all the bytes for this message.
java.lang.String	getContentType()	Get the Content-Type.
javax.activation.DataHandler	getDataHandler()	Get the DataHandler object for this message.
java.lang.String	getDescription()	Get the decoded Content-Description.
java.lang.String	getDisposition()	Get the Content-Disposition.
java.lang.String	getEncoding()	Get the Content-Transfer-Encoding.
protected int	getFetchBlockSize()
java.lang.String	getFileName()	Get the "filename" Disposition parameter.
javax.mail.Flags	getFlags()	Get the Flags for this message.
javax.mail.Address[]	getFrom()	Get the "From" attribute.
java.lang.String[]	getHeader(java.lang.String name)	Get the named header.
java.lang.String	getHeader(java.lang.String name, java.lang.String delimiter)	Get the named header.
java.lang.String	getInReplyTo()	Get the In-Reply-To header.
java.lang.Object	getItem(com.sun.mail.imap.protocol.FetchItem fitem)	Return the data associated with the FetchItem.
int	getLineCount()	Get the total number of lines.
java.util.Enumeration<java.lang.String>	getMatchingHeaderLines(java.lang.String[] names)	Get all matching header-lines.
java.util.Enumeration<javax.mail.Header>	getMatchingHeaders(java.lang.String[] names)	Get matching headers.
protected java.lang.Object	getMessageCacheLock()	Get the messageCacheLock, associated with this Message's Folder.
java.lang.String	getMessageID()	Get the Message-ID.
java.io.InputStream	getMimeStream()	Return the MIME format stream corresponding to this message.
long	getModSeq()	Return the modification sequence number (MODSEQ) for this message.
java.util.Enumeration<java.lang.String>	getNonMatchingHeaderLines(java.lang.String[] names)	Get all non-matching headerlines.
java.util.Enumeration<javax.mail.Header>	getNonMatchingHeaders(java.lang.String[] names)	Get non-matching headers.
boolean	getPeek()	Get whether or not to use the PEEK variant of FETCH when fetching message content.
protected com.sun.mail.imap.protocol.IMAPProtocol	getProtocol()	Get this message's folder's protocol connection.
java.util.Date	getReceivedDate()	Get the received date (INTERNALDATE).
javax.mail.Address[]	getRecipients(javax.mail.Message.RecipientType type)	Get the desired Recipient type.
javax.mail.Address[]	getReplyTo()	Get the ReplyTo addresses.
javax.mail.Address	getSender()	Get the "Sender" attribute.
java.util.Date	getSentDate()	Get the SentDate.
protected int	getSequenceNumber()	Get this message's IMAP sequence number.
int	getSize()	Get the message size.
long	getSizeLong()	Get the message size as a long.
java.lang.String	getSubject()	Get the decoded subject.
protected long	getUID()	Return the UID for this message.
protected void	handleExtensionFetchItems(java.util.Map<java.lang.String,java.lang.Object> extensionItems)	Apply the data in the extension FETCH items to this message.
protected boolean	handleFetchItem(com.sun.mail.imap.protocol.Item item, java.lang.String[] hdrs, boolean allHeaders)	Apply the data in the FETCH item to this message.
protected boolean	ignoreBodyStructureSize()
void	invalidateHeaders()	Invalidate cached header and envelope information for this message.
protected boolean	isREV1()
boolean	isSet(javax.mail.Flags.Flag flag)	Test if the given Flags are set in this message.
void	removeHeader(java.lang.String name)
void	setContentID(java.lang.String cid)
void	setContentLanguage(java.lang.String[] languages)
void	setContentMD5(java.lang.String md5)
void	setDataHandler(javax.activation.DataHandler content)
void	setDescription(java.lang.String description, java.lang.String charset)
void	setDisposition(java.lang.String disposition)
protected void	setExpunged(boolean set)
void	setFileName(java.lang.String filename)
void	setFlags(javax.mail.Flags flag, boolean set)	Set/Unset the given flags in this message.
void	setFrom(javax.mail.Address address)
void	setHeader(java.lang.String name, java.lang.String value)
protected void	setMessageNumber(int msgnum)	Wrapper around the protected method Message.setMessageNumber() to make that method accessible to IMAPFolder.
void	setPeek(boolean peek)	Set whether or not to use the PEEK variant of FETCH when fetching message content.
void	setRecipients(javax.mail.Message.RecipientType type, javax.mail.Address[] addresses)
void	setReplyTo(javax.mail.Address[] addresses)
void	setSender(javax.mail.Address address)
void	setSentDate(java.util.Date d)
void	setSubject(java.lang.String subject, java.lang.String charset)
protected void	setUID(long uid)
void	writeTo(java.io.OutputStream os)	Write out the bytes into the given OutputStream.

Methods inherited from class javax.mail.internet.MimeMessage

addRecipients, createInternetHeaders, createMimeMessage, getAllRecipients, getContent, getInputStream, getRawInputStream, isMimeType, parse, reply, reply, saveChanges, setContent, setContent, setDescription, setFrom, setFrom, setRecipients, setSubject, setText, setText, setText, updateHeaders, updateMessageID, writeTo

Methods inherited from class javax.mail.Message

addRecipient, getFolder, getMessageNumber, getSession, isExpunged, match, setFlag, setRecipient

Methods inherited from class java.lang.Object

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

Field Detail

bs

protected com.sun.mail.imap.protocol.BODYSTRUCTURE bs

envelope

protected com.sun.mail.imap.protocol.ENVELOPE envelope

items

protected java.util.Map<java.lang.String,java.lang.Object> items

A map of the extension FETCH items. In addition to saving the data in this map, an entry in this map indicates that we *have* the data, and so it doesn't need to be fetched again. The map is created only when needed, to avoid significantly increasing the effective size of an IMAPMessage object.

Since:

JavaMail 1.4.6

sectionId

protected java.lang.String sectionId

Constructor Detail

IMAPMessage

protected IMAPMessage(IMAPFolder folder,
                      int msgnum)

Constructor.

Parameters:

folder - the folder containing this message

msgnum - the message sequence number

IMAPMessage

protected IMAPMessage(javax.mail.Session session)

Constructor, for use by IMAPNestedMessage.

Parameters:

session - the Session

Method Detail

getProtocol

protected com.sun.mail.imap.protocol.IMAPProtocol getProtocol()
                                                       throws ProtocolException,
                                                              javax.mail.FolderClosedException

Get this message's folder's protocol connection. Throws FolderClosedException, if the protocol connection is not available. ASSERT: Must hold the messageCacheLock.

Returns:

the IMAPProtocol object for the containing folder

Throws:

ProtocolException - for protocol errors

javax.mail.FolderClosedException - if the folder is closed

isREV1

protected boolean isREV1()
                  throws javax.mail.FolderClosedException

Throws:

javax.mail.FolderClosedException

getMessageCacheLock

protected java.lang.Object getMessageCacheLock()

Get the messageCacheLock, associated with this Message's Folder.

Returns:

the message cache lock object

getSequenceNumber

protected int getSequenceNumber()

Get this message's IMAP sequence number. ASSERT: This method must be called only when holding the messageCacheLock.

Returns:

the message sequence number

setMessageNumber

protected void setMessageNumber(int msgnum)

Wrapper around the protected method Message.setMessageNumber() to make that method accessible to IMAPFolder.

Overrides:

setMessageNumber in class javax.mail.Message

getUID

protected long getUID()

Return the UID for this message. Returns -1 if not known; use UIDFolder.getUID() in this case.

Returns:

the UID

See Also:

UIDFolder.getUID(javax.mail.Message)

setUID

protected void setUID(long uid)

getModSeq

public long getModSeq()
               throws javax.mail.MessagingException

Return the modification sequence number (MODSEQ) for this message. Returns -1 if not known.

Returns:

the modification sequence number

Throws:

javax.mail.MessagingException - for failures

Since:

JavaMail 1.5.1

See Also:

"RFC 4551"

setExpunged

protected void setExpunged(boolean set)

Overrides:

setExpunged in class javax.mail.Message

checkExpunged

protected void checkExpunged()
                      throws javax.mail.MessageRemovedException

Throws:

javax.mail.MessageRemovedException

forceCheckExpunged

protected void forceCheckExpunged()
                           throws javax.mail.MessageRemovedException,
                                  javax.mail.FolderClosedException

Do a NOOP to force any untagged EXPUNGE responses and then check if this message is expunged.

Throws:

javax.mail.MessageRemovedException - if the message has been removed

javax.mail.FolderClosedException - if the folder has been closed

getFetchBlockSize

protected int getFetchBlockSize()

ignoreBodyStructureSize

protected boolean ignoreBodyStructureSize()

getFrom

public javax.mail.Address[] getFrom()
                             throws javax.mail.MessagingException

Get the "From" attribute.

Overrides:

getFrom in class javax.mail.internet.MimeMessage

Throws:

javax.mail.MessagingException

setFrom

public void setFrom(javax.mail.Address address)
             throws javax.mail.MessagingException

Overrides:

setFrom in class javax.mail.internet.MimeMessage

Throws:

javax.mail.MessagingException

addFrom

public void addFrom(javax.mail.Address[] addresses)
             throws javax.mail.MessagingException

Overrides:

addFrom in class javax.mail.internet.MimeMessage

Throws:

javax.mail.MessagingException

getSender

public javax.mail.Address getSender()
                             throws javax.mail.MessagingException

Get the "Sender" attribute.

Overrides:

getSender in class javax.mail.internet.MimeMessage

Throws:

javax.mail.MessagingException

setSender

public void setSender(javax.mail.Address address)
               throws javax.mail.MessagingException

Overrides:

setSender in class javax.mail.internet.MimeMessage

Throws:

javax.mail.MessagingException

getRecipients

public javax.mail.Address[] getRecipients(javax.mail.Message.RecipientType type)
                                   throws javax.mail.MessagingException

Get the desired Recipient type.

Overrides:

getRecipients in class javax.mail.internet.MimeMessage

Throws:

javax.mail.MessagingException

setRecipients

public void setRecipients(javax.mail.Message.RecipientType type,
                          javax.mail.Address[] addresses)
                   throws javax.mail.MessagingException

Overrides:

setRecipients in class javax.mail.internet.MimeMessage

Throws:

javax.mail.MessagingException

addRecipients

public void addRecipients(javax.mail.Message.RecipientType type,
                          javax.mail.Address[] addresses)
                   throws javax.mail.MessagingException

Overrides:

addRecipients in class javax.mail.internet.MimeMessage

Throws:

javax.mail.MessagingException

getReplyTo

public javax.mail.Address[] getReplyTo()
                                throws javax.mail.MessagingException

Get the ReplyTo addresses.

Overrides:

getReplyTo in class javax.mail.internet.MimeMessage

Throws:

javax.mail.MessagingException

setReplyTo

public void setReplyTo(javax.mail.Address[] addresses)
                throws javax.mail.MessagingException

Overrides:

setReplyTo in class javax.mail.internet.MimeMessage

Throws:

javax.mail.MessagingException

getSubject

public java.lang.String getSubject()
                            throws javax.mail.MessagingException

Get the decoded subject.

Overrides:

getSubject in class javax.mail.internet.MimeMessage

Throws:

javax.mail.MessagingException

setSubject

public void setSubject(java.lang.String subject,
                       java.lang.String charset)
                throws javax.mail.MessagingException

Overrides:

setSubject in class javax.mail.internet.MimeMessage

Throws:

javax.mail.MessagingException

getSentDate

public java.util.Date getSentDate()
                           throws javax.mail.MessagingException

Get the SentDate.

Overrides:

getSentDate in class javax.mail.internet.MimeMessage

Throws:

javax.mail.MessagingException

setSentDate

public void setSentDate(java.util.Date d)
                 throws javax.mail.MessagingException

Overrides:

setSentDate in class javax.mail.internet.MimeMessage

Throws:

javax.mail.MessagingException

getReceivedDate

public java.util.Date getReceivedDate()
                               throws javax.mail.MessagingException

Get the received date (INTERNALDATE).

Overrides:

getReceivedDate in class javax.mail.internet.MimeMessage

Throws:

javax.mail.MessagingException

getSize

public int getSize()
            throws javax.mail.MessagingException

Get the message size.

Note that this returns RFC822.SIZE. That is, it's the size of the whole message, header and body included. Note also that if the size of the message is greater than Integer.MAX_VALUE (2GB), this method returns Integer.MAX_VALUE.

Specified by:

getSize in interface javax.mail.Part

Overrides:

getSize in class javax.mail.internet.MimeMessage

Throws:

javax.mail.MessagingException

getSizeLong

public long getSizeLong()
                 throws javax.mail.MessagingException

Get the message size as a long.

Suitable for messages that might be larger than 2GB.

Returns:

the message size as a long integer

Throws:

javax.mail.MessagingException - for failures

Since:

JavaMail 1.6

getLineCount

public int getLineCount()
                 throws javax.mail.MessagingException

Get the total number of lines.

Returns the "body_fld_lines" field from the BODYSTRUCTURE. Note that this field is available only for text/plain and message/rfc822 types

Specified by:

getLineCount in interface javax.mail.Part

Overrides:

getLineCount in class javax.mail.internet.MimeMessage

Throws:

javax.mail.MessagingException

getContentLanguage

public java.lang.String[] getContentLanguage()
                                      throws javax.mail.MessagingException

Get the content language.

Specified by:

getContentLanguage in interface javax.mail.internet.MimePart

Overrides:

getContentLanguage in class javax.mail.internet.MimeMessage

Throws:

javax.mail.MessagingException

setContentLanguage

public void setContentLanguage(java.lang.String[] languages)
                        throws javax.mail.MessagingException

Specified by:

setContentLanguage in interface javax.mail.internet.MimePart

Overrides:

setContentLanguage in class javax.mail.internet.MimeMessage

Throws:

javax.mail.MessagingException

getInReplyTo

public java.lang.String getInReplyTo()
                              throws javax.mail.MessagingException

Get the In-Reply-To header.

Returns:

the In-Reply-To header

Throws:

javax.mail.MessagingException - for failures

Since:

JavaMail 1.3.3

getContentType

public java.lang.String getContentType()
                                throws javax.mail.MessagingException

Get the Content-Type. Generate this header from the BODYSTRUCTURE. Append parameters as well.

Specified by:

getContentType in interface javax.mail.Part

Overrides:

getContentType in class javax.mail.internet.MimeMessage

Throws:

javax.mail.MessagingException

getDisposition

public java.lang.String getDisposition()
                                throws javax.mail.MessagingException

Get the Content-Disposition.

Specified by:

getDisposition in interface javax.mail.Part

Overrides:

getDisposition in class javax.mail.internet.MimeMessage

Throws:

javax.mail.MessagingException

setDisposition

public void setDisposition(java.lang.String disposition)
                    throws javax.mail.MessagingException

Specified by:

setDisposition in interface javax.mail.Part

Overrides:

setDisposition in class javax.mail.internet.MimeMessage

Throws:

javax.mail.MessagingException

getEncoding

public java.lang.String getEncoding()
                             throws javax.mail.MessagingException

Get the Content-Transfer-Encoding.

Specified by:

getEncoding in interface javax.mail.internet.MimePart

Overrides:

getEncoding in class javax.mail.internet.MimeMessage

Throws:

javax.mail.MessagingException

getContentID

public java.lang.String getContentID()
                              throws javax.mail.MessagingException

Get the Content-ID.

Specified by:

getContentID in interface javax.mail.internet.MimePart

Overrides:

getContentID in class javax.mail.internet.MimeMessage

Throws:

javax.mail.MessagingException

setContentID

public void setContentID(java.lang.String cid)
                  throws javax.mail.MessagingException

Overrides:

setContentID in class javax.mail.internet.MimeMessage

Throws:

javax.mail.MessagingException

getContentMD5

public java.lang.String getContentMD5()
                               throws javax.mail.MessagingException

Get the Content-MD5.

Specified by:

getContentMD5 in interface javax.mail.internet.MimePart

Overrides:

getContentMD5 in class javax.mail.internet.MimeMessage

Throws:

javax.mail.MessagingException

setContentMD5

public void setContentMD5(java.lang.String md5)
                   throws javax.mail.MessagingException

Specified by:

setContentMD5 in interface javax.mail.internet.MimePart

Overrides:

setContentMD5 in class javax.mail.internet.MimeMessage

Throws:

javax.mail.MessagingException

getDescription

public java.lang.String getDescription()
                                throws javax.mail.MessagingException

Get the decoded Content-Description.

Specified by:

getDescription in interface javax.mail.Part

Overrides:

getDescription in class javax.mail.internet.MimeMessage

Throws:

javax.mail.MessagingException

setDescription

public void setDescription(java.lang.String description,
                           java.lang.String charset)
                    throws javax.mail.MessagingException

Overrides:

setDescription in class javax.mail.internet.MimeMessage

Throws:

javax.mail.MessagingException

getMessageID

public java.lang.String getMessageID()
                              throws javax.mail.MessagingException

Get the Message-ID.

Overrides:

getMessageID in class javax.mail.internet.MimeMessage

Throws:

javax.mail.MessagingException

getFileName

public java.lang.String getFileName()
                             throws javax.mail.MessagingException

Get the "filename" Disposition parameter. (Only available in IMAP4rev1). If thats not available, get the "name" ContentType parameter.

Specified by:

getFileName in interface javax.mail.Part

Overrides:

getFileName in class javax.mail.internet.MimeMessage

Throws:

javax.mail.MessagingException

setFileName

public void setFileName(java.lang.String filename)
                 throws javax.mail.MessagingException

Specified by:

setFileName in interface javax.mail.Part

Overrides:

setFileName in class javax.mail.internet.MimeMessage

Throws:

javax.mail.MessagingException

getContentStream

protected java.io.InputStream getContentStream()
                                        throws javax.mail.MessagingException

Get all the bytes for this message. Overrides getContentStream() in MimeMessage. This method is ultimately used by the DataHandler to obtain the input stream for this message.

Overrides:

getContentStream in class javax.mail.internet.MimeMessage

Throws:

javax.mail.MessagingException

See Also:

MimeMessage.getContentStream()

getDataHandler

public javax.activation.DataHandler getDataHandler()
                                            throws javax.mail.MessagingException

Get the DataHandler object for this message.

Specified by:

getDataHandler in interface javax.mail.Part

Overrides:

getDataHandler in class javax.mail.internet.MimeMessage

Throws:

javax.mail.MessagingException

setDataHandler

public void setDataHandler(javax.activation.DataHandler content)
                    throws javax.mail.MessagingException

Specified by:

setDataHandler in interface javax.mail.Part

Overrides:

setDataHandler in class javax.mail.internet.MimeMessage

Throws:

javax.mail.MessagingException

getMimeStream

public java.io.InputStream getMimeStream()
                                  throws javax.mail.MessagingException

Return the MIME format stream corresponding to this message.

Specified by:

getMimeStream in interface com.sun.mail.util.ReadableMime

Returns:

the MIME format stream

Throws:

javax.mail.MessagingException

Since:

JavaMail 1.4.5

writeTo

public void writeTo(java.io.OutputStream os)
             throws java.io.IOException,
                    javax.mail.MessagingException

Write out the bytes into the given OutputStream.

Specified by:

writeTo in interface javax.mail.Part

Overrides:

writeTo in class javax.mail.internet.MimeMessage

Throws:

java.io.IOException

javax.mail.MessagingException

getHeader

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

Get the named header.

Specified by:

getHeader in interface javax.mail.Part

Overrides:

getHeader in class javax.mail.internet.MimeMessage

Throws:

javax.mail.MessagingException

getHeader

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

Get the named header.

Specified by:

getHeader in interface javax.mail.internet.MimePart

Overrides:

getHeader in class javax.mail.internet.MimeMessage

Throws:

javax.mail.MessagingException

setHeader

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

Specified by:

setHeader in interface javax.mail.Part

Overrides:

setHeader in class javax.mail.internet.MimeMessage

Throws:

javax.mail.MessagingException

addHeader

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

Specified by:

addHeader in interface javax.mail.Part

Overrides:

addHeader in class javax.mail.internet.MimeMessage

Throws:

javax.mail.MessagingException

removeHeader

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

Specified by:

removeHeader in interface javax.mail.Part

Overrides:

removeHeader in class javax.mail.internet.MimeMessage

Throws:

javax.mail.MessagingException

getAllHeaders

public java.util.Enumeration<javax.mail.Header> getAllHeaders()
                                                       throws javax.mail.MessagingException

Get all headers.

Specified by:

getAllHeaders in interface javax.mail.Part

Overrides:

getAllHeaders in class javax.mail.internet.MimeMessage

Throws:

javax.mail.MessagingException

getMatchingHeaders

public java.util.Enumeration<javax.mail.Header> getMatchingHeaders(java.lang.String[] names)
                                                            throws javax.mail.MessagingException

Get matching headers.

Specified by:

getMatchingHeaders in interface javax.mail.Part

Overrides:

getMatchingHeaders in class javax.mail.internet.MimeMessage

Throws:

javax.mail.MessagingException

getNonMatchingHeaders

public java.util.Enumeration<javax.mail.Header> getNonMatchingHeaders(java.lang.String[] names)
                                                               throws javax.mail.MessagingException

Get non-matching headers.

Specified by:

getNonMatchingHeaders in interface javax.mail.Part

Overrides:

getNonMatchingHeaders in class javax.mail.internet.MimeMessage

Throws:

javax.mail.MessagingException

addHeaderLine

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

Specified by:

addHeaderLine in interface javax.mail.internet.MimePart

Overrides:

addHeaderLine in class javax.mail.internet.MimeMessage

Throws:

javax.mail.MessagingException

getAllHeaderLines

public java.util.Enumeration<java.lang.String> getAllHeaderLines()
                                                          throws javax.mail.MessagingException

Get all header-lines.

Specified by:

getAllHeaderLines in interface javax.mail.internet.MimePart

Overrides:

getAllHeaderLines in class javax.mail.internet.MimeMessage

Throws:

javax.mail.MessagingException

getMatchingHeaderLines

public java.util.Enumeration<java.lang.String> getMatchingHeaderLines(java.lang.String[] names)
                                                               throws javax.mail.MessagingException

Get all matching header-lines.

Specified by:

getMatchingHeaderLines in interface javax.mail.internet.MimePart

Overrides:

getMatchingHeaderLines in class javax.mail.internet.MimeMessage

Throws:

javax.mail.MessagingException

getNonMatchingHeaderLines

public java.util.Enumeration<java.lang.String> getNonMatchingHeaderLines(java.lang.String[] names)
                                                                  throws javax.mail.MessagingException

Get all non-matching headerlines.

Specified by:

getNonMatchingHeaderLines in interface javax.mail.internet.MimePart

Overrides:

getNonMatchingHeaderLines in class javax.mail.internet.MimeMessage

Throws:

javax.mail.MessagingException

getFlags

public javax.mail.Flags getFlags()
                          throws javax.mail.MessagingException

Get the Flags for this message.

Overrides:

getFlags in class javax.mail.internet.MimeMessage

Throws:

javax.mail.MessagingException

isSet

public boolean isSet(javax.mail.Flags.Flag flag)
              throws javax.mail.MessagingException

Test if the given Flags are set in this message.

Overrides:

isSet in class javax.mail.internet.MimeMessage

Throws:

javax.mail.MessagingException

setFlags

public void setFlags(javax.mail.Flags flag,
                     boolean set)
              throws javax.mail.MessagingException

Set/Unset the given flags in this message.

Overrides:

setFlags in class javax.mail.internet.MimeMessage

Throws:

javax.mail.MessagingException

setPeek

public void setPeek(boolean peek)

Set whether or not to use the PEEK variant of FETCH when fetching message content. This overrides the default value from the "mail.imap.peek" property.

Parameters:

peek - the peek flag

Since:

JavaMail 1.3.3

getPeek

public boolean getPeek()

Get whether or not to use the PEEK variant of FETCH when fetching message content.

Returns:

the peek flag

Since:

JavaMail 1.3.3

invalidateHeaders

public void invalidateHeaders()

Invalidate cached header and envelope information for this message. Subsequent accesses of this information will cause it to be fetched from the server.

Since:

JavaMail 1.3.3

handleFetchItem

protected boolean handleFetchItem(com.sun.mail.imap.protocol.Item item,
                                  java.lang.String[] hdrs,
                                  boolean allHeaders)
                           throws javax.mail.MessagingException

Apply the data in the FETCH item to this message. ASSERT: Must hold the messageCacheLock.

Parameters:

item - the fetch item

hdrs - the headers we're asking for

allHeaders - load all headers?

Returns:

did we handle this fetch item?

Throws:

javax.mail.MessagingException - for failures

Since:

JavaMail 1.4.6

handleExtensionFetchItems

protected void handleExtensionFetchItems(java.util.Map<java.lang.String,java.lang.Object> extensionItems)

Apply the data in the extension FETCH items to this message. This method adds all the items to the items map. Subclasses may override this method to call super and then also copy the data to a more convenient form. ASSERT: Must hold the messageCacheLock.

Parameters:

extensionItems - the Map to add fetch items to

Since:

JavaMail 1.4.6

fetchItem

protected java.lang.Object fetchItem(com.sun.mail.imap.protocol.FetchItem fitem)
                              throws javax.mail.MessagingException

Fetch an individual item for the current message. Note that handleExtensionFetchItems will have been called to store this item in the message before this method returns.

Parameters:

fitem - the FetchItem

Returns:

the data associated with the FetchItem

Throws:

javax.mail.MessagingException - for failures

Since:

JavaMail 1.4.6

getItem

public java.lang.Object getItem(com.sun.mail.imap.protocol.FetchItem fitem)
                         throws javax.mail.MessagingException

Return the data associated with the FetchItem. If the data hasn't been fetched, call the fetchItem method to fetch it. Returns null if there is no data for the FetchItem.

Parameters:

fitem - the FetchItem

Returns:

the data associated with the FetchItem

Throws:

javax.mail.MessagingException - for failures

Since:

JavaMail 1.4.6