Interface MessagingProxyManager

All Superinterfaces:

AutoCloseable, Closeable, MessagingProfile, OsidProfile, OsidProxyManager, OsidProxyManager, Sourceable

public interface MessagingProxyManager
extends OsidProxyManager, MessagingProfile

The message manager provides access to message lookup and creation session and provides interoperability tests for various aspects of this service. Methods in this manager support the passing of a Proxy for the purposes of passing information from a server environment. The sessions included in this manager are:

• MessagingSession : a session to send messages
• MessageLookupSession : a session to retrieve messages
• MessageQuerySession : a session to query for messages
• MessageSearchSession : a session to search for messages
• MessageAdminSession : a session to create and delete messages
• MessageNotificationSession : a session to receive notifications pertaining to message changes
• MessageMailboxSession : a session to look up message to mailbox mappings
• MessageMailboxAssignmentSession : a session to manage message to mailbox mappings
• MessageSmartMailboxSession : a session to manage dynamic mailboxes of messages

• ReceiptLookupSession: a session to retrieve message receipts
• ReceiptAdminSession : a session to update message receipts
• ReceiptNotificationSession : a session to receive notifications pertaining to changes in message receipts

• MailboxLookupSession: a session to retrieve mailboxes
• MailboxQuerySession : a session to query mailboxes
• MailboxSearchSession : a session to search for mailboxes
• MailboxAdminSession : a session to create, update and delete mailboxes
• MailboxNotificationSession : a session to receive notifications pertaining to changes in mailboxes
• MailboxHierarchySession : a session to traverse mailbox hierarchies
• MailboxHierarchyDesignSession : a session to manage mailbox hierarchies

Method Summary

Modifier and Type	Method	Description
MailboxAdminSession	getMailboxAdminSession(Proxy proxy)	Gets the mailbox administrative session for creating, updating and deleteing mailboxes.
MailboxHierarchyDesignSession	getMailboxHierarchyDesignSession(Proxy proxy)	Gets the mailbox hierarchy design session.
MailboxHierarchySession	getMailboxHierarchySession(Proxy proxy)	Gets the mailbox hierarchy traversal session.
MailboxLookupSession	getMailboxLookupSession(Proxy proxy)	Gets the mailbox lookup session.
MailboxNotificationSession	getMailboxNotificationSession(MailboxReceiver mailboxReceiver, Proxy proxy)	Gets the notification session for subscribing to changes to a mailbox.
MailboxQuerySession	getMailboxQuerySession(Proxy proxy)	Gets the mailbox query session.
MailboxSearchSession	getMailboxSearchSession(Proxy proxy)	Gets the mailbox search session.
MessageAdminSession	getMessageAdminSession(Proxy proxy)	Gets a message administration session for creating, updating and deleting messages.
MessageAdminSession	getMessageAdminSessionForMailbox(Id mailboxId, Proxy proxy)	Gets a message administration session for the given mailbox.
MessageLookupSession	getMessageLookupSession(Proxy proxy)	Gets the OsidSession associated with the message lookup service.
MessageLookupSession	getMessageLookupSessionForMailbox(Id mailboxId, Proxy proxy)	Gets the OsidSession associated with the message lookup service for the given mailbox.
MessageMailboxAssignmentSession	getMessageMailboxAssignmentSession(Proxy proxy)	Gets the session for assigning message to mailbox mappings.
MessageMailboxSession	getMessageMailboxSession(Proxy proxy)	Gets the session for retrieving message to mailbox mappings.
MessageNotificationSession	getMessageNotificationSession(MessageReceiver messageReceiver, Proxy proxy)	Gets the message notification session for the given mailbox.
MessageNotificationSession	getMessageNotificationSessionForMailbox(MessageReceiver messageReceiver, Id mailboxId, Proxy proxy)	Gets the message notification session for the given mailbox.
MessageQuerySession	getMessageQuerySession(Proxy proxy)	Gets the OsidSession associated with the message query service.
MessageQuerySession	getMessageQuerySessionForMailbox(Id mailboxId, Proxy proxy)	Gets the OsidSession associated with the message query service for the given mailbox.
MessageSearchSession	getMessageSearchSession(Proxy proxy)	Gets a message search session.
MessageSearchSession	getMessageSearchSessionForMailbox(Id mailboxId, Proxy proxy)	Gets a message search session for the given mailbox.
MessageSmartMailboxSession	getMessageSmartMailboxSession(Id mailboxId, Proxy proxy)	Gets the OsidSession to manage message smart mailboxes.
MessagingBatchProxyManager	getMessagingBatchProxyManager()	Gets a MessagingBatchProxyManager .
MessagingSession	getMessagingSession(Proxy proxy)	Gets the OsidSession associated with the message sending service.
ReceiptAdminSession	getReceiptAdminSession(Proxy proxy)	Gets the OsidSession associated with the receipt administrative service.
ReceiptAdminSession	getReceiptAdminSessionForMailbox(Id mailboxId, Proxy proxy)	Gets the OsidSession associated with the receipt administrative service for the given mailbox.
ReceiptLookupSession	getReceiptLookupSession(Proxy proxy)	Gets the OsidSession associated with the receipt lookup service.
ReceiptLookupSession	getReceiptLookupSessionForMailbox(Id mailboxId, Proxy proxy)	Gets the OsidSession associated with the receipt lookup service for the given mailbox.
ReceiptNotificationSession	getReceiptNotificationSession(ReceiptReceiver receiptReceiver, Proxy proxy)	Gets the notification session for notifications pertaining to receipt changes.
ReceiptNotificationSession	getReceiptNotificationSessionForMailbox(ReceiptReceiver receiptReceiver, Id mailboxId, Proxy proxy)	Gets the receipt notification session for the given mailbox.

Methods inherited from interface Closeable

close

Methods inherited from interface MessagingProfile

getMailboxRecordTypes, getMailboxSearchRecordTypes, getMessageRecordTypes, getMessageSearchRecordTypes, getReceiptRecordTypes, supportsMailboxAdmin, supportsMailboxHierarchy, supportsMailboxHierarchyDesign, supportsMailboxLookup, supportsMailboxNotification, supportsMailboxRecordType, supportsMailboxSearch, supportsMailboxSearchRecordType, supportsMessageAdmin, supportsMessageLookup, supportsMessageMailbox, supportsMessageMailboxAssignment, supportsMessageNotification, supportsMessageQuery, supportsMessageRecordType, supportsMessageSearch, supportsMessageSearchRecordType, supportsMessageSmartMailbox, supportsMessaging, supportsMessagingBatch, supportsReceiptAdmin, supportsReceiptLookup, supportsReceiptNotification, supportsReceiptRecordType, supportsVisibleFederation

Modifier and Type	Method	Description
TypeList	getMailboxRecordTypes()	Gets all the mailbox record types supported.
TypeList	getMailboxSearchRecordTypes()	Gets all the mailbox search record types supported.
TypeList	getMessageRecordTypes()	Gets all the message record types supported.
TypeList	getMessageSearchRecordTypes()	Gets all the message search record types supported.
TypeList	getReceiptRecordTypes()	Gets all the receipt record types supported.
boolean	supportsMailboxAdmin()	Tests if mailbox administration is supported.
boolean	supportsMailboxHierarchy()	Tests if a mailbox hierarchy traversal is supported.
boolean	supportsMailboxHierarchyDesign()	Tests if a mailbox hierarchy design is supported.
boolean	supportsMailboxLookup()	Tests if mailbox lookup is supported.
boolean	supportsMailboxNotification()	Tests if mailbox notification is supported.
boolean	supportsMailboxRecordType(Type mailboxRecordType)	Tests if a given mailbox record type is supported.
boolean	supportsMailboxSearch()	Tests if mailbox search is supported.
boolean	supportsMailboxSearchRecordType(Type mailboxSearchRecordType)	Tests if a given mailbox search record type is supported.
boolean	supportsMessageAdmin()	Tests if creating, updating and deleting messages is supported.
boolean	supportsMessageLookup()	Tests if message lookup is supported.
boolean	supportsMessageMailbox()	Tests if retrieving mappings of message and mailboxes is supported.
boolean	supportsMessageMailboxAssignment()	Tests if managing mappings of messages and mailboxes is supported.
boolean	supportsMessageNotification()	Tests if message notification is supported.
boolean	supportsMessageQuery()	Tests if querying messages is supported.
boolean	supportsMessageRecordType(Type messageRecordType)	Tests if a given message record type is supported.
boolean	supportsMessageSearch()	Tests if message search is supported.
boolean	supportsMessageSearchRecordType(Type messageSearchRecordType)	Tests if a given message search type is supported.
boolean	supportsMessageSmartMailbox()	Tests if a messaging smart mailbox service is supported.
boolean	supportsMessaging()	Tests if sending messages is supported.
boolean	supportsMessagingBatch()	Tests if a messaging batch service is supported.
boolean	supportsReceiptAdmin()	Tests if updating receipts is supported.
boolean	supportsReceiptLookup()	Tests if receipt lookup is supported.
boolean	supportsReceiptNotification()	Tests if receipts notification is supported.
boolean	supportsReceiptRecordType(Type receiptRecordType)	Tests if a given receipt record type is supported.
boolean	supportsVisibleFederation()	Tests if federation is visible.

Methods inherited from interface OsidProfile

getBranch, getBranchId, getDescription, getDisplayName, getId, getLocales, getProxyRecordTypes, getReleaseDate, getVersion, supportsJournalBranching, supportsJournalRollback, supportsOSIDVersion, supportsProxyRecordType

Modifier and Type	Method	Description
Branch	getBranch()	Gets this service branch.
Id	getBranchId()	Gets the Branch Id representing this service branch.
DisplayText	getDescription()	Gets a description of this service implementation.
DisplayText	getDisplayName()	Gets a display name for this service implementation.
Id	getId()	Gets an identifier for this service implementation.
LocaleList	getLocales()	Gets the locales supported in this service.
TypeList	getProxyRecordTypes()	Gets the proxy record Types supported in this service.
DateTime	getReleaseDate()	Gets the date this service implementation was released.
Version	getVersion()	Gets the version of this service implementation.
boolean	supportsJournalBranching()	Test for support of a journal branching service.
boolean	supportsJournalRollback()	Test for support of a journaling rollback service.
boolean	supportsOSIDVersion(Version version)	Test for support of an OSID specification version.
boolean	supportsProxyRecordType(Type proxyRecordType)	Test for support of a proxy type.

Methods inherited from interface OsidProxyManager

close

Modifier and Type	Method	Description
void	close()	Close this manager.

Methods inherited from interface OsidProxyManager

changeBranch, initialize, rollbackService

Modifier and Type	Method	Description
void	changeBranch(Id branchId, Proxy proxy)	Changes the service branch.
void	initialize(OsidRuntimeManager runtime)	Initializes this manager.
JournalEntry	rollbackService(Date rollbackTime, Proxy proxy)	Rolls back this service to a point in time.

Methods inherited from interface Sourceable

getBranding, getBrandingIds, getLicense, getProvider, getProviderId

Modifier and Type	Method	Description
AssetList	getBranding()	Gets a branding, such as an image or logo, expressed using the Asset interface.
IdList	getBrandingIds()	Gets the branding asset Ids .
DisplayText	getLicense()	Gets the terms of usage.
Resource	getProvider()	Gets the Resource representing the provider.
Id	getProviderId()	Gets the Id of the provider.

Method Details

getMessagingSession

MessagingSession getMessagingSession(Proxy proxy)
                              throws OperationFailedException

Gets the OsidSession associated with the message sending service.

Parameters:

proxy - a proxy

Returns:

a MessagingSession

Throws:

NullArgumentException - proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsMessaging() is false

Compliance:

optional - This method must be implemented if {@code supportsMessaging()} is {@code true} .

getMessageLookupSession

MessageLookupSession getMessageLookupSession(Proxy proxy)
                                      throws OperationFailedException

Gets the OsidSession associated with the message lookup service.

Parameters:

proxy - a proxy

Returns:

a MessageLookupSession

Throws:

NullArgumentException - proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsMessageLookup() is false

Compliance:

optional - This method must be implemented if {@code supportsMessageLookup()} is {@code true} .

getMessageLookupSessionForMailbox

MessageLookupSession getMessageLookupSessionForMailbox(Id mailboxId,
 Proxy proxy)
                                                throws NotFoundException,
OperationFailedException

Gets the OsidSession associated with the message lookup service for the given mailbox.

Parameters:

mailboxId - the Id of the mailbox

proxy - a proxy

Returns:

a MessageLookupSession

Throws:

NotFoundException - mailboxId not found

NullArgumentException - mailboxId or proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsMessageLookup() or supportsVisibleFederation() is false

Compliance:

optional - This method must be implemented if {@code supportsMessageLookup()} and {@code supportsVisibleFederation()} are {@code true} .

getMessageQuerySession

MessageQuerySession getMessageQuerySession(Proxy proxy)
                                    throws OperationFailedException

Gets the OsidSession associated with the message query service.

Parameters:

proxy - a proxy

Returns:

a MessageQuerySession

Throws:

NullArgumentException - proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsMessageQuery() is false

Compliance:

optional - This method must be implemented if {@code supportsMessageQuery()} is {@code true} .

getMessageQuerySessionForMailbox

MessageQuerySession getMessageQuerySessionForMailbox(Id mailboxId,
 Proxy proxy)
                                              throws NotFoundException,
OperationFailedException

Gets the OsidSession associated with the message query service for the given mailbox.

Parameters:

mailboxId - the Id of the mailbox

proxy - a proxy

Returns:

a MessageQuerySession

Throws:

NotFoundException - no Mailbox found by the given Id

NullArgumentException - mailboxId or proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsMessageQuery() or supportsVisibleFederation() is false

Compliance:

optional - This method must be implemented if {@code supportsMessageQuery()} and {@code supportsVisibleFederation()} are {@code true}

getMessageSearchSession

MessageSearchSession getMessageSearchSession(Proxy proxy)
                                      throws OperationFailedException

Gets a message search session.

Parameters:

proxy - a proxy

Returns:

a MessageSearchSession

Throws:

NullArgumentException - proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsMessageSearch() is false

Compliance:

optional - This method must be implemented if {@code supportsMessageSearch()} is {@code true} .

getMessageSearchSessionForMailbox

MessageSearchSession getMessageSearchSessionForMailbox(Id mailboxId,
 Proxy proxy)
                                                throws NotFoundException,
OperationFailedException

Gets a message search session for the given mailbox.

Parameters:

mailboxId - the Id of the mailbox

proxy - a proxy

Returns:

a MessageSearchSession

Throws:

NotFoundException - mailboxId not found

NullArgumentException - mailboxId or proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsMessageSearch() or supportsVisibleFederation() is false

Compliance:

optional - This method must be implemented if {@code supportsMessageSearch()} and {@code supportsVisibleFederation()} are {@code true} .

getMessageAdminSession

MessageAdminSession getMessageAdminSession(Proxy proxy)
                                    throws OperationFailedException

Gets a message administration session for creating, updating and deleting messages.

Parameters:

proxy - a proxy

Returns:

a MessageAdminSession

Throws:

NullArgumentException - proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsMessageAdmin() is false

Compliance:

optional - This method must be implemented if {@code supportsMessageAdmin()} is {@code true} .

getMessageAdminSessionForMailbox

MessageAdminSession getMessageAdminSessionForMailbox(Id mailboxId,
 Proxy proxy)
                                              throws NotFoundException,
OperationFailedException

Gets a message administration session for the given mailbox.

Parameters:

mailboxId - the Id of the mailbox

proxy - a proxy

Returns:

a MessageAdminSession

Throws:

NotFoundException - mailboxId not found

NullArgumentException - mailboxId or proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsMessageAdmin() or supportsVisibleFederation() is false

Compliance:

optional - This method must be implemented if {@code supportsMessageAdmin()} and {@code supportsVisibleFederation()} are {@code true} .

getMessageNotificationSession

MessageNotificationSession getMessageNotificationSession(MessageReceiver messageReceiver,
 Proxy proxy)
                                                  throws OperationFailedException

Gets the message notification session for the given mailbox.

Parameters:

messageReceiver - notification callback

proxy - a proxy

Returns:

a MessageNotificationSession

Throws:

NullArgumentException - messageReceiver or proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsMessageNotification() is false

Compliance:

optional - This method must be implemented if {@code supportsMessageNotification()} is {@code true} .

getMessageNotificationSessionForMailbox

MessageNotificationSession getMessageNotificationSessionForMailbox(MessageReceiver messageReceiver,
 Id mailboxId,
 Proxy proxy)
                                                            throws NotFoundException,
OperationFailedException

Gets the message notification session for the given mailbox.

Parameters:

messageReceiver - notification callback

mailboxId - the Id of the mailbox

proxy - a proxy

Returns:

a MessageNotificationSession

Throws:

NotFoundException - mailboxId not found

NullArgumentException - messageReceiver, mailboxId or proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsMessageNotification() or supportsVisibleFederation() is false

Compliance:

optional - This method must be implemented if {@code supportsMessageNotfication()} and {@code supportsVisibleFederation()} are {@code true} .

getMessageMailboxSession

MessageMailboxSession getMessageMailboxSession(Proxy proxy)
                                        throws OperationFailedException

Gets the session for retrieving message to mailbox mappings.

Parameters:

proxy - a proxy

Returns:

a MessageMailboxSession

Throws:

NullArgumentException - proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsMessageMailbox() is false

Compliance:

optional - This method must be implemented if {@code supportsMessageMailbox()} is {@code true} .

getMessageMailboxAssignmentSession

MessageMailboxAssignmentSession getMessageMailboxAssignmentSession(Proxy proxy)
                                                            throws OperationFailedException

Gets the session for assigning message to mailbox mappings.

Parameters:

proxy - a proxy

Returns:

a MessageMailboxAssignmentSession

Throws:

NullArgumentException - proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsMessageMailboxAssignment() is false

Compliance:

optional - This method must be implemented if {@code supportsMessageMailboxAssignment()} is {@code true} .

getMessageSmartMailboxSession

MessageSmartMailboxSession getMessageSmartMailboxSession(Id mailboxId,
 Proxy proxy)
                                                  throws NotFoundException,
OperationFailedException

Gets the OsidSession to manage message smart mailboxes.

Parameters:

mailboxId - the Id of the mailbox

proxy - a proxy

Returns:

a MessageSmartMailboxesession

Throws:

NotFoundException - mailboxId not found

NullArgumentException - mailboxId or proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsMessageSmartMailbox() is false

Compliance:

optional - This method must be implemented if {@code supportsMessageSmartMailbox()} is {@code true} .

getReceiptLookupSession

ReceiptLookupSession getReceiptLookupSession(Proxy proxy)
                                      throws OperationFailedException

Gets the OsidSession associated with the receipt lookup service.

Parameters:

proxy - a proxy

Returns:

a ReceiptLookupSession

Throws:

NullArgumentException - proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsReceiptLookup() is false

Compliance:

optional - This method must be implemented if {@code supportsReceiptLookup()} is {@code true} .

getReceiptLookupSessionForMailbox

ReceiptLookupSession getReceiptLookupSessionForMailbox(Id mailboxId,
 Proxy proxy)
                                                throws NotFoundException,
OperationFailedException

Gets the OsidSession associated with the receipt lookup service for the given mailbox.

Parameters:

mailboxId - the Id of the mailbox

proxy - a proxy

Returns:

a ReceiptLookupSession

Throws:

NotFoundException - mailboxId not found

NullArgumentException - mailboxId or proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsReceiptLookup() or supportsVisibleFederation() is false

Compliance:

optional - This method must be implemented if {@code supportsReceiptLookup()} and {@code supportsVisibleFederation()} are {@code true} .

getReceiptAdminSession

ReceiptAdminSession getReceiptAdminSession(Proxy proxy)
                                    throws OperationFailedException

Gets the OsidSession associated with the receipt administrative service.

Parameters:

proxy - a proxy

Returns:

a ReceiptAdminSession

Throws:

NullArgumentException - proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsReceiptAdmin() is false

Compliance:

optional - This method must be implemented if {@code supportsReceiptAdmin()} is {@code true} .

getReceiptAdminSessionForMailbox

ReceiptAdminSession getReceiptAdminSessionForMailbox(Id mailboxId,
 Proxy proxy)
                                              throws NotFoundException,
OperationFailedException

Gets the OsidSession associated with the receipt administrative service for the given mailbox.

Parameters:

mailboxId - the Id of the mailbox

proxy - a proxy

Returns:

a ReceiptAdminSession

Throws:

NotFoundException - mailboxId not found

NullArgumentException - mailboxId or proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsReceiptAdmin() or supportsVisibleFederation() is false

Compliance:

optional - This method must be implemented if {@code supportsReceiptAdmin()} and {@code supportsVisibleFederation()} are {@code true} .

getReceiptNotificationSession

ReceiptNotificationSession getReceiptNotificationSession(ReceiptReceiver receiptReceiver,
 Proxy proxy)
                                                  throws OperationFailedException

Gets the notification session for notifications pertaining to receipt changes.

Parameters:

receiptReceiver - the notification callback

proxy - a proxy

Returns:

a ReceiptNotificationSession

Throws:

NullArgumentException - receiptReceiver or proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsReceiptNotification() is false

Compliance:

optional - This method must be implemented if {@code supportsreceiptNotification()} is {@code true} .

getReceiptNotificationSessionForMailbox

ReceiptNotificationSession getReceiptNotificationSessionForMailbox(ReceiptReceiver receiptReceiver,
 Id mailboxId,
 Proxy proxy)
                                                            throws NotFoundException,
OperationFailedException

Gets the receipt notification session for the given mailbox.

Parameters:

receiptReceiver - the notification callback

mailboxId - the Id of the mailbox

proxy - a proxy

Returns:

a ReceiptNotificationSession

Throws:

NotFoundException - mailboxId not found

NullArgumentException - receiptReceiver, mailboxId or proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsReceiptNotification() or supportsVisibleFederation() is false

Compliance:

optional - This method must be implemented if {@code supportsReceiptNotfication()} and {@code supportsVisibleFederation()} are {@code true} .

getMailboxLookupSession

MailboxLookupSession getMailboxLookupSession(Proxy proxy)
                                      throws OperationFailedException

Gets the mailbox lookup session.

Parameters:

proxy - a proxy

Returns:

a MailboxLookupSession

Throws:

NullArgumentException - proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsMailboxLookup() is false

Compliance:

optional - This method must be implemented if {@code supportsMailboxLookup()} is {@code true} .

getMailboxQuerySession

MailboxQuerySession getMailboxQuerySession(Proxy proxy)
                                    throws OperationFailedException

Gets the mailbox query session.

Parameters:

proxy - a proxy

Returns:

a MailboxQuerySession

Throws:

NullArgumentException - proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsMailboxQuery() is false

Compliance:

optional - This method must be implemented if {@code supportsMailboxQuery()} is {@code true} .

getMailboxSearchSession

MailboxSearchSession getMailboxSearchSession(Proxy proxy)
                                      throws OperationFailedException

Gets the mailbox search session.

Parameters:

proxy - a proxy

Returns:

a MailboxSearchSession

Throws:

NullArgumentException - proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsMailboxSearch() is false

Compliance:

optional - This method must be implemented if {@code supportsMailboxSearch()} is {@code true} .

getMailboxAdminSession

MailboxAdminSession getMailboxAdminSession(Proxy proxy)
                                    throws OperationFailedException

Gets the mailbox administrative session for creating, updating and deleteing mailboxes.

Parameters:

proxy - a proxy

Returns:

a MailboxAdminSession

Throws:

NullArgumentException - proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsMailboxAdmin() is false

Compliance:

optional - This method must be implemented if {@code supportsMailboxAdmin()} is {@code true} .

getMailboxNotificationSession

MailboxNotificationSession getMailboxNotificationSession(MailboxReceiver mailboxReceiver,
 Proxy proxy)
                                                  throws OperationFailedException

Gets the notification session for subscribing to changes to a mailbox.

Parameters:

mailboxReceiver - notification callback

proxy - a proxy

Returns:

a MailboxNotificationSession

Throws:

NullArgumentException - mailboxReceiver or proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsMailboxNotification() is false

Compliance:

optional - This method must be implemented if {@code supportsMailboxNotification()} is {@code true} .

getMailboxHierarchySession

MailboxHierarchySession getMailboxHierarchySession(Proxy proxy)
                                            throws OperationFailedException

Gets the mailbox hierarchy traversal session.

Parameters:

proxy - a proxy

Returns:

a MailboxHierarchySession

Throws:

NullArgumentException - proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsMailboxHierarchy() is false

Compliance:

optional - This method must be implemented if {@code supportsMailboxHierarchy()} is {@code true} .

getMailboxHierarchyDesignSession

MailboxHierarchyDesignSession getMailboxHierarchyDesignSession(Proxy proxy)
                                                        throws OperationFailedException

Gets the mailbox hierarchy design session.

Parameters:

proxy - a proxy

Returns:

a MailboxHierarchyDesignSession

Throws:

NullArgumentException - proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsMailboxHierarchyDesign() is false

Compliance:

optional - This method must be implemented if {@code supportsMailboxHierarchyDesign()} is {@code true} .

getMessagingBatchProxyManager

MessagingBatchProxyManager getMessagingBatchProxyManager()
                                                  throws OperationFailedException

Gets a MessagingBatchProxyManager .

Returns:

a MessagingBatchProxyManager

Throws:

OperationFailedException - unable to complete request

UnimplementedException - supportsMessagingBatch() is false

Compliance:

optional - This method must be implemented if {@code supportsMessagingBatch()} is {@code true} .