|
Compoze Software, Inc. | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--com.compoze.domino.Folders
This class contains the methods used for folder manipulation.
Method Summary | |
void |
serverCopyFolder(java.lang.String sSourceFolderID,
java.lang.String sTargetFolderID,
java.lang.String sNewName)
Hits the server to copy folders to another folder. |
Folder |
serverCreateFolder(java.lang.String sFolderID,
java.lang.String sName,
PropertyKey[] keys)
Hits the server to add a folder. |
void |
serverDeleteFolders(java.lang.String[] folderIDs)
Hits the server to delete a folder. |
Folder |
serverGetFolder(FolderType type,
PropertyKey[] keys)
Queries the server to get a single folder by type. |
Folder |
serverGetFolder(java.lang.String sFolderID,
PropertyKey[] keys)
Queries the server to get a single folder. |
Folder[] |
serverGetFolders(PropertyKey[] keys,
java.lang.String[] expandedFolderIDs)
Queries the server to get sub-folders off of a folder. |
Folder[] |
serverGetSubFolders(java.lang.String sID,
int iDepth,
PropertyKey[] keys)
Gets the subfolders. |
void |
serverMoveFolder(java.lang.String sSourceFolderID,
java.lang.String sTargetFolderID)
Hits the server to move folders to another folder. |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Method Detail |
public Folder serverGetFolder(FolderType type, PropertyKey[] keys) throws DominoException
FolderType.PERSONAL
is specified.type
- the folder typekeys
- the properties to fetch for the foldernull
if not foundpublic Folder serverGetFolder(java.lang.String sFolderID, PropertyKey[] keys) throws DominoException
sFolderID
- the folder IDkeys
- the properties to fetch for the foldernull
if not foundpublic Folder[] serverGetSubFolders(java.lang.String sID, int iDepth, PropertyKey[] keys) throws DominoException
sID
- the folder IDiDepth
- the depth of folders to retrieve (N for depth of N, -1 for infinite depth)keys
- the properties to bring back from the new folder or null
to not retrieve the newly created folderpublic Folder[] serverGetFolders(PropertyKey[] keys, java.lang.String[] expandedFolderIDs) throws DominoException
keys
- the properties to fetch for each folderexpandedFolderIDs
- the IDs of folders below a depth of 1 which
are to be expanded (null
for none)public Folder serverCreateFolder(java.lang.String sFolderID, java.lang.String sName, PropertyKey[] keys) throws DominoException
Note: If you specify a parent folder and that folder cannot hold sub-folders, the new folder is created at the root level.
sFolderID
- the ID of the parent folder or null
for rootsName
- the name of the new folder (use '\' characters to create a folder hierarchy)keys
- the properties to bring back from the new folder or null
to not retrieve the newly created folderkeys
Folder.holdFolders()
public void serverDeleteFolders(java.lang.String[] folderIDs) throws DominoException
folderIDs
- the IDs of the folders to deletepublic void serverCopyFolder(java.lang.String sSourceFolderID, java.lang.String sTargetFolderID, java.lang.String sNewName) throws DominoException
sSourceFolderID
- the ID of the source folderssTargetFolderID
- the ID of the target foldersNewName
- the name for the new folder (or null
to keep the same name) (may not include '\' characters)public void serverMoveFolder(java.lang.String sSourceFolderID, java.lang.String sTargetFolderID) throws DominoException
FolderType.INBOX
FolderType.TRASH
FolderType.DRAFTS
FolderType.SENT
If an attempt is made to move the source folder
to a target folder where a folder already exists with the
same name,
a FolderAlreadyExistsException
is thrown.
Note: The target folder must be able to hold sub-folders.
sSourceFolderID
- the ID of the source foldersTargetFolderID
- the ID of the target folder
|
Compoze Software, Inc. | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |