javax.mail
public abstract class Store extends Service
Version: 1.4
Constructor Summary | |
---|---|
protected | Store(Session session, URLName url)
Constructor. |
Method Summary | |
---|---|
void | addFolderListener(FolderListener l)
Adds a listener for folder events on any folder object obtained from this
store. |
void | addStoreListener(StoreListener l)
Adds a listener for store events on this store. |
abstract Folder | getDefaultFolder()
Returns a folder that represents the root of the primary namespace
presented to the user by this store. |
abstract Folder | getFolder(String name)
Returns the folder with the given name.
|
abstract Folder | getFolder(URLName url)
Returns the folder corresponding to the given URLName. |
Folder[] | getPersonalNamespaces()
Returns the personal namespaces for the authenticated user. |
Folder[] | getSharedNamespaces()
Returns the shared namespaces. |
Folder[] | getUserNamespaces(String user)
Returns the personal namespaces for the specified user. |
protected void | notifyFolderListeners(int type, Folder folder)
Notifies all folder listeners. |
protected void | notifyFolderRenamedListeners(Folder oldFolder, Folder newFolder)
Notifies all folder listeners about the renaming of a folder. |
protected void | notifyStoreListeners(int type, String message)
Notifies all store event listeners. |
void | removeFolderListener(FolderListener l)
Removes a folder event listener. |
void | removeStoreListener(StoreListener l)
Removes a store events listener. |
Parameters: session session context for this store url URLName to be used for this store
Throws: IllegalStateException if the store is not connected
The exists
method can be used to determine whether the
folder actually exists.
In some Stores, name
can be an absolute path if it starts
with the hierarchy delimiter. Otherwise it is interpreted relative
to the root of this namespace.
Parameters: name the folder name
Throws: IllegalStateException if the store is not connected
Parameters: url a URLName denoting a folder
Throws: IllegalStateException if this store is not connected