jodd.mail
Class ReceiveMailSession

java.lang.Object
  jodd.mail.ReceiveMailSession

public class ReceiveMailSession
extends java.lang.Object

Encapsulates email receiving session. Prepares and receives message(s).

Field Summary

protected static java.lang.String	DEFAULT_FOLDER
protected javax.mail.Folder	folder
protected javax.mail.Session	session
protected javax.mail.Store	store
protected static java.lang.String	STR_CHARSET

Constructor Summary

ReceiveMailSession(javax.mail.Session session, javax.mail.Store store)
Creates new mail session.

Method Summary

protected java.lang.String[]	address2String(javax.mail.Address[] addresses) Converts mail address to string.
void	close() Closes session.
protected void	closeFolderIfOpened() Closes folder if opened and expunge deleted messages.
protected java.lang.String	extractEncoding(java.lang.String contentType) Parses content type for encoding.
protected java.lang.String	extractMimeType(java.lang.String contentType) Extracts mime type from parts content type.
int	getMessageCount() Returns number of messages.
int	getNewMessageCount() Returns the number of new messages.
protected ReceivedEmail	message2Email(javax.mail.Message msg)
void	open() Opens session.
protected void	processPart(ReceivedEmail email, javax.mail.Part part) Process single part of received message.
ReceivedEmail[]	receiveEmail(boolean delete) Receives all emails.
void	useDefaultFolder() Opens default folder: INBOX.
void	useFolder(java.lang.String folderName) Opens new folder and closes previously opened folder.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_FOLDER

protected static final java.lang.String DEFAULT_FOLDER

See Also:

Constant Field Values

STR_CHARSET

protected static final java.lang.String STR_CHARSET

See Also:

Constant Field Values

session

protected final javax.mail.Session session

store

protected final javax.mail.Store store

folder

protected javax.mail.Folder folder

Constructor Detail

ReceiveMailSession

public ReceiveMailSession(javax.mail.Session session,
                          javax.mail.Store store)

Creates new mail session.

Method Detail

open

public void open()

Opens session.

useFolder

public void useFolder(java.lang.String folderName)

Opens new folder and closes previously opened folder.

useDefaultFolder

public void useDefaultFolder()

Opens default folder: INBOX.

getMessageCount

public int getMessageCount()

Returns number of messages.

getNewMessageCount

public int getNewMessageCount()

Returns the number of new messages. Not available for the POP3.

receiveEmail

public ReceivedEmail[] receiveEmail(boolean delete)

Receives all emails.

Parameters:

delete - delete received messages

Returns:

array of received messages

message2Email

protected ReceivedEmail message2Email(javax.mail.Message msg)
                               throws javax.mail.MessagingException,
                                      java.io.IOException

Throws:

javax.mail.MessagingException

java.io.IOException

processPart

protected void processPart(ReceivedEmail email,
                           javax.mail.Part part)
                    throws java.io.IOException,
                           javax.mail.MessagingException

Process single part of received message. All parts are simple added to the message, i.e. hierarchy is not saved.

Throws:

java.io.IOException

javax.mail.MessagingException

extractMimeType

protected java.lang.String extractMimeType(java.lang.String contentType)

Extracts mime type from parts content type.

extractEncoding

protected java.lang.String extractEncoding(java.lang.String contentType)

Parses content type for encoding.

address2String

protected java.lang.String[] address2String(javax.mail.Address[] addresses)

Converts mail address to string.

closeFolderIfOpened

protected void closeFolderIfOpened()

Closes folder if opened and expunge deleted messages.

close

public void close()

Closes session.