The method will also prepare the store for use.
Parameters: session - the actual JwmaSession. Parameters: mstore - the mail store that should be wrapped.
moveFolders(String[] foldernames, String destfolder) Moves the given folders to the given destination folder.
Parameters: foldernames - an array of strings; each Stringrepresenting the full path of a valid folder of theactual store. Parameters: destfolder - the full path of a valid folder of theactual store.
Put's a message into the read-mail archive,
if archivation is enabled.
Parameters: message - the Message to be archived. throws: JwmaException - if it fails to archive the message. See Also: javax.mail.Message
Tests if a folder with the given path exists
on the store.
Note that the method checks against the cached folder list.
Parameters: path - the path of the folder as String. true if a folder with this path exists on the store,false otherwise. throws: JwmaException - if the folder already exists, or if it failsto create the folder.
The method will also prepare the store for use.
Parameters: session - the actual JwmaSession. Parameters: mstore - the mail store that should be wrapped. the newly created JwmaStoreImpl instance. throws: JwmaException - if preparing the store for use fails. See Also:JwmaStoreImpl.prepare() See Also:dtw.webmail.JwmaSession See Also: javax.mail.Store
Note that this method will not remove the folder if it is a
special folder.
Parameters: fullname - the folder's path as String. throws: JwmaException - if a folder does not exist,or if an error occurs when deleting.
Note that this method will not remove any special folder from
the store. Despite that, it is a convenience method, looping over
the array and calling deleteFolder() Parameters: folders - an array of strings; each Stringrepresenting the full path of a valid folder of theactual store. throws: JwmaException - if a folder does not exist,or if an error occurs when deleting. See Also:JwmaStoreImpl.deleteFolder(String)
Returns a Folder with a given path
from the mail store.
the folder as Folder. throws: JwmaException - if a folder with the given path does not existon the store or a MessagingException occurs.
Returns the JwmaInboxInfo instance that
can be used to retrieve information about the store's
INBOX folder (i.e. where new messages should be arriving).
the store's INBOX folder as JwmaInboxInfo. See Also:dtw.webmail.model.JwmaInboxInfo
The type of this folder will be
JwmaFolderImpl.TYPE_MESSAGE_CONTAINER.
the read mail archive folder as JwmaFolderImpl. See Also:dtw.webmail.model.JwmaFolderImpl
Returns the JwmaTrashInfo instance that
can be used to retrieve information about the store's
trash folder (i.e. where deleted messages end up first).
the store's trash folder as JwmaTrashInfo. See Also:dtw.webmail.model.JwmaTrashInfo
Tests if the store is mixed mode, which means it can
hold folders that hold messages and subfolders at once.
true if store is supporting mixed mode, falseotherwise.
Note that this method is a convenience method
it creates a single entry array and calls
moveFolders().
Parameters: foldername - the full path of the folder as String. Parameters: destfolder - the full path of a valid folder on theactual store. throws: JwmaException - if a folder does not exist,or if an error occurs when deleting. See Also:JwmaStoreImpl.moveFolders(String[],String)
Moves the given folders to the given destination folder.
Parameters: foldernames - an array of strings; each Stringrepresenting the full path of a valid folder of theactual store. Parameters: destfolder - the full path of a valid folder of theactual store. the new actual folder as JwmaFolder. throws: JwmaException - if the source folders or the destination folderdo not exist, the destination is a subfolder of a source folder,the destination cannot contain any subfolders,or if an error occurs when moving.
Sets a new actual folder from a given path.
the new actual folder as JwmaFolder. throws: JwmaException - if it fails to set the new folder andcreate a JwmaFolder instance with it.
Sets the draft folder from a name or path
given as String.
This method will check and modify the
name as follows:
name is null or an empty string: ++ "draft"
name does not start with : ++name
The method will finally set the newly created folder name in the
associated preferences.
Parameters: name - the name or full name of the draft folderas String. throws: JwmaException - if it fails to set the draft folder andcreate a JwmaFolder instance with it.
The type of this folder will be
JwmaFolderImpl.TYPE_MESSAGE_CONTAINER.
Parameters: f - the read mail archive folder as Folder. See Also: javax.mail.Folder
Sets the read mail archive folder from a name or path
given as String.
This method will first check if the automatic archivation of
read messages is activated. If, then it checks and modifies the
name as follows:
name is null or an empty string: ++ "sent-mail"
name does not start with : ++name
The method will finally set the newly created folder name in the
associated preferences.
Parameters: name - the name or full name of the sent-mail archive folderas String. throws: JwmaException - if it fails to set the read-mail folder andcreate a JwmaFolder instance with it.
The type of this folder will be
JwmaFolderImpl.TYPE_MESSAGE_CONTAINER.
Parameters: f - the sent mail archive folder as Folder. See Also: javax.mail.Folder
Sets the sent mail archive folder from a name or path
given as String.
This method will first check if the automatic archivation of
sent messages is activated. If, then it checks and modifies the
name as follows:
name is null or an empty string: ++ "sent-mail"
name does not start with : ++name
The method will finally set the newly created folder name in the
associated preferences.
Parameters: name - the name or full name of the sent-mail archive folderas String. throws: JwmaException - if it fails to set the sent-mail folder andcreate a JwmaFolder instance with it.
Sets the trash folder from a name or path
given as String.
This method will check and modify the
name as follows:
name is null or an empty string: ++ "trash"
name does not start with : ++name
The method will finally set the newly created folder name in the
associated preferences.
Parameters: name - the name or full name of the draft folderas String. throws: JwmaException - if it fails to set the draft folder andcreate a JwmaFolder instance with it.