com.sun.mail.imap

Class IMAPMessage

java.lang.Object

MimeMessage

com.sun.mail.imap.IMAPMessage

All Implemented Interfaces:

ReadableMime

Direct Known Subclasses:

IMAPNestedMessage

public class IMAPMessage
extends MimeMessage
implements 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 and Description
static class	IMAPMessage.FetchProfileCondition This class implements the test to be done on each message in the folder.

Method Summary

Modifier and Type	Method and Description
void	addFrom(Address[] addresses)
void	addHeader(java.lang.String name, java.lang.String value)
void	addHeaderLine(java.lang.String line)
void	addRecipients(Message.RecipientType type, Address[] addresses)
java.util.Enumeration	getAllHeaderLines() Get all header-lines.
java.util.Enumeration	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.
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.
java.lang.String	getFileName() Get the "filename" Disposition parameter.
Flags	getFlags() Get the Flags for this message.
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(FetchItem fitem) Return the data associated with the FetchItem.
int	getLineCount() Get the total number of lines.
java.util.Enumeration	getMatchingHeaderLines(java.lang.String[] names) Get all matching header-lines.
java.util.Enumeration	getMatchingHeaders(java.lang.String[] names) Get matching headers.
java.lang.String	getMessageID() Get the Message-ID.
java.io.InputStream	getMimeStream() Return the MIME format stream corresponding to this message.
java.util.Enumeration	getNonMatchingHeaderLines(java.lang.String[] names) Get all non-matching headerlines.
java.util.Enumeration	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.
java.util.Date	getReceivedDate() Get the recieved date (INTERNALDATE)
Address[]	getRecipients(Message.RecipientType type) Get the desired Recipient type.
Address[]	getReplyTo() Get the ReplyTo addresses.
Address	getSender() Get the "Sender" attribute.
java.util.Date	getSentDate() Get the SentDate.
int	getSize() Get the message size.
java.lang.String	getSubject() Get the decoded subject.
void	invalidateHeaders() Invalidate cached header and envelope information for this message.
boolean	isSet(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)
void	setFileName(java.lang.String filename)
void	setFlags(Flags flag, boolean set) Set/Unset the given flags in this message.
void	setFrom(Address address)
void	setHeader(java.lang.String name, java.lang.String value)
void	setPeek(boolean peek) Set whether or not to use the PEEK variant of FETCH when fetching message content.
void	setRecipients(Message.RecipientType type, Address[] addresses)
void	setReplyTo(Address[] addresses)
void	setSender(Address address)
void	setSentDate(java.util.Date d)
void	setSubject(java.lang.String subject, java.lang.String charset)
void	writeTo(java.io.OutputStream os) Write out the bytes into the given OutputStream.

Methods inherited from class java.lang.Object

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

Method Detail

getFrom

public Address[] getFrom()
                  throws MessagingException

Get the "From" attribute.

Throws:

MessagingException

setFrom

public void setFrom(Address address)
             throws MessagingException

Throws:

MessagingException

addFrom

public void addFrom(Address[] addresses)
             throws MessagingException

Throws:

MessagingException

getSender

public Address getSender()
                  throws MessagingException

Get the "Sender" attribute.

Throws:

MessagingException

setSender

public void setSender(Address address)
               throws MessagingException

Throws:

MessagingException

getRecipients

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

Get the desired Recipient type.

Throws:

MessagingException

setRecipients

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

Throws:

MessagingException

addRecipients

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

Throws:

MessagingException

getReplyTo

public Address[] getReplyTo()
                     throws MessagingException

Get the ReplyTo addresses.

Throws:

MessagingException

setReplyTo

public void setReplyTo(Address[] addresses)
                throws MessagingException

Throws:

MessagingException

getSubject

public java.lang.String getSubject()
                            throws MessagingException

Get the decoded subject.

Throws:

MessagingException

setSubject

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

Throws:

MessagingException

getSentDate

public java.util.Date getSentDate()
                           throws MessagingException

Get the SentDate.

Throws:

MessagingException

setSentDate

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

Throws:

MessagingException

getReceivedDate

public java.util.Date getReceivedDate()
                               throws MessagingException

Get the recieved date (INTERNALDATE)

Throws:

MessagingException

getSize

public int getSize()
            throws 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.

Throws:

MessagingException

getLineCount

public int getLineCount()
                 throws 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

Throws:

MessagingException

getContentLanguage

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

Get the content language.

Throws:

MessagingException

setContentLanguage

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

Throws:

MessagingException

getInReplyTo

public java.lang.String getInReplyTo()
                              throws MessagingException

Get the In-Reply-To header.

Throws:

MessagingException

Since:

JavaMail 1.3.3

getContentType

public java.lang.String getContentType()
                                throws MessagingException

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

Throws:

MessagingException

getDisposition

public java.lang.String getDisposition()
                                throws MessagingException

Get the Content-Disposition.

Throws:

MessagingException

setDisposition

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

Throws:

MessagingException

getEncoding

public java.lang.String getEncoding()
                             throws MessagingException

Get the Content-Transfer-Encoding.

Throws:

MessagingException

getContentID

public java.lang.String getContentID()
                              throws MessagingException

Get the Content-ID.

Throws:

MessagingException

setContentID

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

Throws:

MessagingException

getContentMD5

public java.lang.String getContentMD5()
                               throws MessagingException

Get the Content-MD5.

Throws:

MessagingException

setContentMD5

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

Throws:

MessagingException

getDescription

public java.lang.String getDescription()
                                throws MessagingException

Get the decoded Content-Description.

Throws:

MessagingException

setDescription

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

Throws:

MessagingException

getMessageID

public java.lang.String getMessageID()
                              throws MessagingException

Get the Message-ID.

Throws:

MessagingException

getFileName

public java.lang.String getFileName()
                             throws MessagingException

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

Throws:

MessagingException

setFileName

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

Throws:

MessagingException

getDataHandler

public javax.activation.DataHandler getDataHandler()
                                            throws MessagingException

Get the DataHandler object for this message.

Throws:

MessagingException

setDataHandler

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

Throws:

MessagingException

getMimeStream

public java.io.InputStream getMimeStream()
                                  throws MessagingException

Return the MIME format stream corresponding to this message.

Specified by:

getMimeStream in interface ReadableMime

Returns:

the MIME format stream

Throws:

MessagingException

Since:

JavaMail 1.4.5

writeTo

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

Write out the bytes into the given OutputStream.

Throws:

java.io.IOException

MessagingException

getHeader

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

Get the named header.

Throws:

MessagingException

getHeader

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

Get the named header.

Throws:

MessagingException

setHeader

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

Throws:

MessagingException

addHeader

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

Throws:

MessagingException

removeHeader

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

Throws:

MessagingException

getAllHeaders

public java.util.Enumeration getAllHeaders()
                                    throws MessagingException

Get all headers.

Throws:

MessagingException

getMatchingHeaders

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

Get matching headers.

Throws:

MessagingException

getNonMatchingHeaders

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

Get non-matching headers.

Throws:

MessagingException

addHeaderLine

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

Throws:

MessagingException

getAllHeaderLines

public java.util.Enumeration getAllHeaderLines()
                                        throws MessagingException

Get all header-lines.

Throws:

MessagingException

getMatchingHeaderLines

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

Get all matching header-lines.

Throws:

MessagingException

getNonMatchingHeaderLines

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

Get all non-matching headerlines.

Throws:

MessagingException

getFlags

public Flags getFlags()
               throws MessagingException

Get the Flags for this message.

Throws:

MessagingException

isSet

public boolean isSet(Flags.Flag flag)
              throws MessagingException

Test if the given Flags are set in this message.

Throws:

MessagingException

setFlags

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

Set/Unset the given flags in this message.

Throws:

MessagingException

setPeek

public void setPeek(boolean peek)

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

Since:

JavaMail 1.3.3

getPeek

public boolean getPeek()

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

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

getItem

public java.lang.Object getItem(FetchItem fitem)
                         throws 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.

Throws:

MessagingException

Since:

JavaMail 1.4.6