org.jasig.portlet.emailpreview.dao
Interface IEmailAccountService

All Known Implementing Classes:

DemoAccountService, JavamailAccountService

public interface IEmailAccountService

IEmailAccountDao is repsonsible for retrieving email messages from an arbitrary email store.

Author:

Jen Bourey, jbourey@unicon.net, Drew Wills, drew@unicon.net

Method Summary

boolean	deleteMessages(javax.portlet.PortletRequest req, long[] uids) Delete and expunge the specified massages from the store.
AccountSummary	getAccountSummary(javax.portlet.PortletRequest req, int start, int max, boolean refresh) Obtains the AccountSummary object from the data store itself, or possibly from cache.
EmailMessage	getMessage(javax.portlet.PortletRequest req, int messageNum) Retrieve an individual message from the mail store.
boolean	setSeenFlag(javax.portlet.PortletRequest req, long[] uids, boolean value) Switch the value of the SEEN flag for the specified messages.

Method Detail

getAccountSummary

AccountSummary getAccountSummary(javax.portlet.PortletRequest req,
                                 int start,
                                 int max,
                                 boolean refresh)
                                 throws EmailPreviewException

Obtains the AccountSummary object from the data store itself, or possibly from cache.

Parameters:

req - The current PortletRequest

start -

max - The maximum number of messages (header info) that may be returned with the summary

refresh - True if the concrete service implementation must not return cached data; otherwise false

Returns:

Throws:

MailAuthenticationException - When authentication with the mail server fails

EmailPreviewException - On other errors

getMessage

EmailMessage getMessage(javax.portlet.PortletRequest req,
                        int messageNum)

Retrieve an individual message from the mail store.

Parameters:

req - The current PortletRequest

messageNum - Index of the selected message

Returns:

deleteMessages

boolean deleteMessages(javax.portlet.PortletRequest req,
                       long[] uids)

Delete and expunge the specified massages from the store. Supported for implementations that provide UIDs (e.g. UIDFolder) only.

Parameters:

req - The current PortletRequest

uids - Array of message UIDs to delete

Returns:

Success or failure

setSeenFlag

boolean setSeenFlag(javax.portlet.PortletRequest req,
                    long[] uids,
                    boolean value)

Switch the value of the SEEN flag for the specified messages. Supported for implementations that provide UIDs (e.g. UIDFolder) only.

Parameters:

req - The current PortletRequest

uids -

value - The new value of the seen flag

Returns:

Success or failure