|
Compoze Software, Inc. | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--com.compoze.exchange.AbstractItem | +--com.compoze.exchange.Folder
This class is an Exchange folder. Folder instances are obtained
from the Folders
. Methods that access properites on the
class require that the properties were loaded beforehand, when the folder
was initially retrieved. Any methods in this class that begin
with the string server
make a query to the server, and require
that the PropertyKey.FOLDER_ID
property be loaded beforehand.
Any additional property requirements are indicated on each individual method.
Field Summary | |
static PropertyKey[] |
ALL_PROPS
Contains an array of all of the properties available on a folder. |
Fields inherited from class com.compoze.exchange.AbstractItem |
m_props, m_session |
Method Summary | |
java.lang.String |
getAbsoluteName()
Gets the absolute name of the folder (including its full path relative to the top of the information store). |
FolderType |
getFolderType()
Gets the type of the folder. |
java.lang.String |
getID()
Gets the ID of the folder. |
int |
getMessageCount()
Gets the number of messages in the folder. |
java.lang.String |
getName()
Gets the folder name. |
int |
getRelativeDepth()
Gets the depth of the folder relative to the query that was made to retrieve it. |
int |
getSubFolderCount()
Gets the number of subfolders. |
int |
getUnreadMessageCount()
Gets the number of unread messages in the folder. |
boolean |
hasSubFolders()
Determines if a folder has subfolders. |
void |
serverCopyTo(java.lang.String sFolderID,
java.lang.String sNewName,
boolean bRecursive)
Hits the server to copy the folder to another folder. |
Contact |
serverCreateContact(PropertyValue[] values)
Hits the server to create a contact. |
Folder |
serverCreateFolder(java.lang.String sName,
PropertyValue[] values,
PropertyKey[] keys)
Hits the server to add a folder below the current folder. |
Journal |
serverCreateJournal(PropertyValue[] values)
Hits the server to create a journal. |
java.lang.String |
serverCreateMessage(PropertyValue[] values)
Hits the server to create a message. |
java.lang.String |
serverCreateMessage(PropertyValue[] values,
Recipient[] recipients)
Hits the server to create a message. |
Task |
serverCreateTask(PropertyValue[] values)
Hits the server to create a task. |
void |
serverDelete()
Hits the server to delete the folder (the folder is removed permanently, and not moved into deleted items). |
void |
serverDelete(boolean bDeletedItems)
Hits the server to delete the folder. |
Contact[] |
serverGetContacts(int iStartIndex,
int iEndIndex,
int iDepth,
PropertyKey[] keys,
SortProperty[] sortProps,
PropertyValue[] filterProps,
boolean bOr,
boolean bNot,
boolean bHidden)
Queries the server to get contacts. |
Contact[] |
serverGetContacts(int iStartIndex,
int iEndIndex,
PropertyKey[] keys)
Queries the server to get contacts from the server between the specified iStartIndex and iEndIndex
starting at 1. |
int |
serverGetMessageCount()
Queries the server to get a count of messages at a depth of 1 off this folder. |
int |
serverGetMessageCount(int iDepth,
PropertyValue[] filterProps,
boolean bOr,
boolean bNot,
boolean bHidden)
Queries the server to get a count of messages. |
Message[] |
serverGetMessages(int iStartIndex,
int iEndIndex,
int iDepth,
PropertyKey[] keys,
SortProperty[] sortProps,
PropertyValue[] filterProps,
boolean bOr,
boolean bNot,
boolean bHidden)
Queries the server to get messages from the server between the specified iStartIndex and iEndIndex
starting at 1. |
Message[] |
serverGetMessages(int iStartIndex,
int iEndIndex,
PropertyKey[] keys)
Queries the server to get messages from the server between the specified iStartIndex and iEndIndex
starting at 1. |
Folder |
serverGetParentFolder(PropertyKey[] props)
Queries the server to get the parent folder. |
Folder[] |
serverGetSubFolders(PropertyKey[] keys)
Queries the server to get all subfolders at a depth of 1 off of this folder. |
Folder[] |
serverGetSubFolders(PropertyKey[] keys,
int iDepth)
Queries the server to get subfolders off of this folder. |
Task[] |
serverGetTasks(int iStartIndex,
int iEndIndex,
int iDepth,
PropertyKey[] keys,
SortProperty[] sortProps,
PropertyValue[] filterProps,
boolean bOr,
boolean bNot,
boolean bHidden)
Queries the server to get tasks. |
Task[] |
serverGetTasks(int iStartIndex,
int iEndIndex,
PropertyKey[] keys)
Queries the server to get tasks from the server between the specified iStartIndex and iEndIndex
starting at 1. |
boolean |
serverIsDefaultFolderType(DefaultFolderType type)
Queries the server to determine if this folder is the specified default folder type. |
void |
serverMoveTo(java.lang.String sFolderID)
Hits the server to move the folder to another folder. |
void |
serverUpdate()
Hits the server to update any changed properties. |
void |
setFolderType(java.lang.String sName)
Sets the type of the folder (container class). |
void |
setName(java.lang.String sName)
Sets the folder name. |
java.lang.String |
toString()
Returns the string representation of the folder. |
Methods inherited from class com.compoze.exchange.AbstractItem |
get, getBoolean, getByteArray, getDate, getDouble, getInt, getInvalidPropertyValues, getPropertyKeys, getString, getStringArray, getUpdatedPropertyValues, set, setBoolean, setByteArray, setDate, setDouble, setInt, setString, setStringArray |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Field Detail |
public static final PropertyKey[] ALL_PROPS
Method Detail |
public java.lang.String serverCreateMessage(PropertyValue[] values) throws ExchangeException
values
- any initial property values to setExchangeException
- if a problem occurs while connecting to
or interacting with Exchangepublic java.lang.String serverCreateMessage(PropertyValue[] values, Recipient[] recipients) throws ExchangeException
values
- any initial property values to setrecipients
- the initial recipients to add to the message
(null
for no initial recipients)ExchangeException
- if a problem occurs while connecting to
or interacting with Exchangepublic Contact serverCreateContact(PropertyValue[] values) throws ExchangeException
values
- any initial property values to setpublic Task serverCreateTask(PropertyValue[] values) throws ExchangeException
values
- any initial property values to setpublic Journal serverCreateJournal(PropertyValue[] values) throws ExchangeException
values
- any initial property values to setpublic Folder[] serverGetSubFolders(PropertyKey[] keys) throws ExchangeException
keys
- the properties to fetch for each folder, or
null
for all of the default propertiespublic Folder[] serverGetSubFolders(PropertyKey[] keys, int iDepth) throws ExchangeException
keys
- the properties to fetch for each folder, or
null
for all of the default propertiesiDepth
- the depth of folders to retrieve (0 for
only starting folder, N for depth of N, -1 for
infinite depth)public Folder serverCreateFolder(java.lang.String sName, PropertyValue[] values, PropertyKey[] keys) throws ExchangeException
sName
- the name of the new foldervalues
- any initial property values to setkeys
- the properties to bring back from the new folderpublic void serverDelete() throws ExchangeException
public void serverDelete(boolean bDeletedItems) throws ExchangeException
bDeletedItems
- if true
, move the folder
into deleted itemspublic void serverCopyTo(java.lang.String sFolderID, java.lang.String sNewName, boolean bRecursive) throws ExchangeException
sFolderID
- the ID of the target foldersNewName
- the name for the new folder (or null
to keep the same namebRecursive
- if true
, also copy subfolderspublic void serverMoveTo(java.lang.String sFolderID) throws ExchangeException
sFolderID
- the ID of the target folderpublic void serverUpdate() throws ExchangeException
serverUpdate
in class AbstractItem
public Folder serverGetParentFolder(PropertyKey[] props) throws ExchangeException
props
- the properties to retrievenull
if no parent existspublic Message[] serverGetMessages(int iStartIndex, int iEndIndex, PropertyKey[] keys) throws ExchangeException
iStartIndex
and iEndIndex
starting at 1.iStartIndex
- the start index endpoint (inclusive) or -1 for alliEndIndex
- the end index highpoint (exclusive) or -1 for allkeys
- the properties to bring back from the messagepublic Message[] serverGetMessages(int iStartIndex, int iEndIndex, int iDepth, PropertyKey[] keys, SortProperty[] sortProps, PropertyValue[] filterProps, boolean bOr, boolean bNot, boolean bHidden) throws ExchangeException
iStartIndex
and iEndIndex
starting at 1.iStartIndex
- the start index endpoint (inclusive) or -1 for alliEndIndex
- the end index highpoint (exclusive) or -1 for alliDepth
- the depth of folders to use when calculating message count (0 for
only starting folder, N for depth of N, -1 for
infinite depth)keys
- the properties to bring back from the messagesortProps
- the properties to sort byfilterProps
- the properties to filter bybOr
- if true
, or the filter properties
togetherbNot
- if true
, the condition is oppositebHidden
- if true
, get hidden messages
rather than visible onespublic int serverGetMessageCount() throws ExchangeException
public int serverGetMessageCount(int iDepth, PropertyValue[] filterProps, boolean bOr, boolean bNot, boolean bHidden) throws ExchangeException
iDepth
- the depth of folders to use when calculating message count (0 for
only starting folder, N for depth of N, -1 for
infinite depth)filterProps
- the properties to filter by; passing null
in this parameter will
not traverse subfolders, even if -1 is specified for iDepth
bOr
- if true
, or the filter properties
togetherbNot
- if true
, the condition is oppositebHidden
- if true
, get hidden messages
rather than visible onespublic boolean serverIsDefaultFolderType(DefaultFolderType type) throws ExchangeException
type
- the default folder type to check (may not be null
)true
if the folder is the specified default folder type; false
otherwisepublic Contact[] serverGetContacts(int iStartIndex, int iEndIndex, PropertyKey[] keys) throws ExchangeException
iStartIndex
and iEndIndex
starting at 1.iStartIndex
- the start index endpoint (inclusive) or -1 for alliEndIndex
- the end index highpoint (exclusive) or -1 for allkeys
- the properties to bring back from the contactpublic Contact[] serverGetContacts(int iStartIndex, int iEndIndex, int iDepth, PropertyKey[] keys, SortProperty[] sortProps, PropertyValue[] filterProps, boolean bOr, boolean bNot, boolean bHidden) throws ExchangeException
iStartIndex
- the start index endpoint (inclusive) or -1 for alliEndIndex
- the end index highpoint (exclusive) or -1 for alliDepth
- the depth of folders to use when calculating message count (0 for
only starting folder, N for depth of N, -1 for
infinite depth)keys
- the properties to fetch for each contactsortProps
- the properties to sort byfilterProps
- the properties to filter bybOr
- if true
, or the filter properties
togetherbNot
- if true
, the condition is oppositebHidden
- if true
, get hidden messages
rather than visible onespublic Task[] serverGetTasks(int iStartIndex, int iEndIndex, PropertyKey[] keys) throws ExchangeException
iStartIndex
and iEndIndex
starting at 1.iStartIndex
- the start index endpoint (inclusive) or -1 for alliEndIndex
- the end index highpoint (exclusive) or -1 for allkeys
- the properties to bring back from the taskpublic Task[] serverGetTasks(int iStartIndex, int iEndIndex, int iDepth, PropertyKey[] keys, SortProperty[] sortProps, PropertyValue[] filterProps, boolean bOr, boolean bNot, boolean bHidden) throws ExchangeException
iStartIndex
- the start index endpoint (inclusive) or -1 for alliEndIndex
- the end index highpoint (exclusive) or -1 for alliDepth
- the depth of folders to use when calculating message count (0 for
only starting folder, N for depth of N, -1 for
infinite depth)keys
- the properties to fetch for each tasksortProps
- the properties to sort byfilterProps
- the properties to filter bybOr
- if true
, or the filter properties
togetherbNot
- if true
, the condition is oppositebHidden
- if true
, get hidden messages
rather than visible onespublic java.lang.String getID() throws ExchangeException
PropertyKey.FOLDER_ID
public java.lang.String getName() throws ExchangeException
PropertyKey.FOLDER_NAME
public void setName(java.lang.String sName) throws ExchangeException
sName
- the folder namePropertyKey.FOLDER_NAME
public int getRelativeDepth() throws ExchangeException
PropertyKey.FOLDER_RELATIVE_DEPTH
public java.lang.String getAbsoluteName() throws ExchangeException
PropertyKey.FOLDER_ABSOLUTE_NAME
public int getSubFolderCount() throws ExchangeException
PropertyKey.FOLDER_SUBFOLDER_COUNT
public int getMessageCount() throws ExchangeException
PropertyKey.FOLDER_MESSAGE_COUNT
public int getUnreadMessageCount() throws ExchangeException
PropertyKey.FOLDER_MESSAGE_UNREAD_COUNT
public FolderType getFolderType() throws ExchangeException
null
if type is not availablePropertyKey.CONTAINER_CLASS
,
FolderType
public boolean hasSubFolders() throws ExchangeException
true
if the folder has subfoldersPropertyKey.FOLDER_SUBFOLDER_COUNT
public void setFolderType(java.lang.String sName) throws ExchangeException
PropertyKey.CONTAINER_CLASS
public java.lang.String toString()
toString
in class java.lang.Object
PropertyKey.FOLDER_NAME
,
PropertyKey.FOLDER_ID
,
PropertyKey.CONTAINER_CLASS
|
Compoze Software, Inc. | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |