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