Class BaseMailController
- extends BaseController
- Known Subclasses:
-
CachedMailController
Mail controller provides all methods to mail related items, including folders
and messages settings for the currently active user.
Methods
void
addFolder
(
)
Add a new folder
void
deleteFolder
(
)
Delete the given folder
void
deleteMessages
(
)
Delete the given message
void
destroy
(
)
MailController destroy.
void
emptyFolder
(
)
Empty the given folder
void
filterMessages
(
)
Abstract method to filter messages for the given item container based on the given filter type. This method
resets the paginator object to hold the newly filtered messages.
object
getFolderObject
(
)
Get a folder object for the given folder. Object properties
are: fid, fn, sys, totalMsgNUm, totalUnreadMsgNum
- Returns:
object
- A folder object
void
getMessage
(
)
Abstract method to get the message with the given folder name and message ID
void
getMessages
(
)
Abstract method for getting messages for the given item container from the cache
void
getPOPEmails
(
)
POP Account Aggregation. Retrieves email from user-configured POP accounts.
String
getSelectedFolder
(
)
Get the currently selected folder. Folder name is returned with "folder_" prefix.
- Returns:
String
- The selected folder's name (returned with "folder_" prefix).
object
getSelectedFolderObject
(
)
Get the currently selected folder object. Object properties
are: fid, fn, sys, totalMsgNUm, totalUnreadMsgNum
- Returns:
object
- The currently selected folder object
Array
getSelectedMessage
(
)
Get the currently selected message
- Returns:
Array
- Array containing the messages folder and message ID
void
loadFolderCount
(
)
Load the count of user's mail folders into the cache
void
loadFolderList
(
)
Load the user's mail folders into the cache
void
loadMessage
(
)
Abstract method to load the given message into the cache
Note: Those who imlement this method are expected to delegate the call to the _doLoadMessage method of the
Base Controller and pass an optional object (last argument) containing any additional URL parameters
then user's preference is ignored and images are loaded
void
loadMessages
(
)
Abstract method called when loading a folder
void
loadUsage
(
)
Retrieve the mail quota from the server for the currently active user
void
markAsSpam
(
)
Mark as Spam / Mark as NOT Spam Method
void
moveMessages
(
)
Move the given message from the current folder to a destination folder
void
renameFolder
(
)
Rename the given folder
void
saveAsDraft
(
)
Save a message as a draft
1) "message:<part-index>:<msgid>:<folder-name>", or
2) "upload:<mime>:<actual-file-name>:<original-file-name>".
The "message" and "upload" component of the attachment parameter describe whether the attachment comes
from another message (in the case of a forward) or from an uploaded file. Each component must be
separated by a ":". Each component must be Base64 encoded so that all special characters (ie. ":") are
removed.
void
sendMessage
(
)
Send a message
1) "message:<part-index>:<msgid>:<folder-name>", or
2) "upload:<mime>:<actual-file-name>:<original-file-name>".
The "message" and "upload" component of the attachment parameter describe whether the attachment comes
from another message (in the case of a forward) or from an uploaded file. Each component must be
separated by a ":". Each component must be Base64 encoded so that all special characters (ie. ":") are
removed.
void
setMessageFlag
(
)
Set the read/unread status for the given messages
void
setSelectedFolder
(
folder
)
Set the currently selected folder.
- Parameters:
-
folder
<String>
Folder name to mark as selected; prefixed with "folder_".
- Returns:
void
void
setSelectedMessage
(
options
)
Set the currently selected message
- Parameters:
-
options
<String>
The message's object
- Returns:
void