Interface ForumProxyManager
- All Superinterfaces:
AutoCloseable, Closeable, ForumProfile, OsidProfile, OsidProxyManager, OsidProxyManager, Sourceable
The reply manager provides access to forum sessions and provides
interoperability tests for various aspects of this service. Methods in
this manager accept a Proxy for passing information from a server
environment. The sessions included in this manager are:
-
PostLookupSession: a session to retrieve posts -
PostQuerySession: a session to query posts -
PostSearchSession: a session to search for posts -
PostAdminSession: a session to create, update and delete posts -
PostNotificationSession: a session to receive notifications for changes in posts -
PostForumSession: a session to lookup post forum mappings -
PostForumAssignmentSession: a session to manage post forum mappings -
PostSmartForumSession: a session to manage smart forums of posts
-
ReplyLookupSession: a session to lookup replies -
ReplyAdminSession: a session to manage replies -
ReplyNotificationSession: a session to subscribe to notifications of reply changes
-
ForumLookupSession: a session to retrieve forums -
ForumQuerySession: a session to query forums -
ForumSearchSession: a session to search for forums -
ForumAdminSession: a session to create, update and delete forums -
ForumNotificationSession: a session to receive notifications for changes in forums -
ForumHierarchySession: a session to traverse hierarchies of forums -
ForumHierarchyDesignSession: a session to manage hierarchies of forums
The forum manager also provides a profile for determing the supported search types supported by this service.
-
Method Summary
Modifier and TypeMethodDescriptiongetForumAdminSession(Proxy proxy) Gets theOsidSessionassociated with the forum administrative service.Gets aForumBatchProxyManager.Gets theOsidSessionassociated with the forum hierarchy design service.getForumHierarchySession(Proxy proxy) Gets theOsidSessionassociated with the forum hierarchy service.getForumLookupSession(Proxy proxy) Gets theOsidSessionassociated with the forum lookup service.getForumNotificationSession(ForumReceiver forumReceiver, Proxy proxy) Gets theOsidSessionassociated with the forum notification service.getForumQuerySession(Proxy proxy) Gets theOsidSessionassociated with the forum query service.getForumSearchSession(Proxy proxy) Gets theOsidSessionassociated with the forum search service.getPostAdminSession(Proxy proxy) Gets theOsidSessionassociated with the post administrative service.getPostAdminSessionForForum(Id forumId, Proxy proxy) Gets theOsidSessionassociated with the post administration service for the given forum.Gets the session for assigning post to forum mappings.getPostForumSession(Proxy proxy) Gets the session for retrieving post to forum mappings.getPostLookupSession(Proxy proxy) Gets theOsidSessionassociated with the post lookup service.getPostLookupSessionForForum(Id forumId, Proxy proxy) Gets theOsidSessionassociated with the post lookup service for the given forum.getPostNotificationSession(PostReceiver postReceiver, Proxy proxy) Gets theOsidSessionassociated with the post notification service.getPostNotificationSessionForForum(PostReceiver postReceiver, Id forumId, Proxy proxy) Gets theOsidSessionassociated with the post notification service for the given forum.getPostQuerySession(Proxy proxy) Gets theOsidSessionassociated with the post query service.getPostQuerySessionForForum(Id forumId, Proxy proxy) Gets theOsidSessionassociated with the post query service for the given forum.getPostSearchSession(Proxy proxy) Gets theOsidSessionassociated with the post search service.getPostSearchSessionForForum(Id forumId, Proxy proxy) Gets theOsidSessionassociated with the post search service for the given forum.getPostSmartForumSession(Id forumId, Proxy proxy) Gets the session for managing dynamic post forums for the given forum.getReplyAdminSession(Proxy proxy) Gets theOsidSessionassociated with the reply administration service.getReplyAdminSessionForForum(Id forumId, Proxy proxy) Gets theOsidSessionassociated with the reply administration service for the given forum.getReplyLookupSession(Proxy proxy) Gets theOsidSessionassociated with the reply lookup service.getReplyLookupSessionForForum(Id forumId, Proxy proxy) Gets theOsidSessionassociated with the reply lookup service for the given forum.getReplyNotificationSession(ReplyReceiver replyReceiver, Proxy proxy) Gets theOsidSessionassociated with the reply notification service.getReplyNotificationSessionForForum(ReplyReceiver replyReceiver, Id forumId, Proxy proxy) Gets theOsidSessionassociated with the reply notification service for the given forum.Methods inherited from interface ForumProfile
getForumRecordTypes, getForumSearchRecordTypes, getPostRecordTypes, getPostSearchRecordTypes, getReplyRecordTypes, getReplySearchRecordTypes, supportsForumAdmin, supportsForumBatch, supportsForumHierarchy, supportsForumHierarchyDesign, supportsForumLookup, supportsForumNotification, supportsForumQuery, supportsForumRecordType, supportsForumSearch, supportsForumSearchRecordType, supportsPostAdmin, supportsPostForum, supportsPostForumAssignment, supportsPostLookup, supportsPostNotification, supportsPostQuery, supportsPostRecordType, supportsPostSearch, supportsPostSearchRecordType, supportsPostSmartForum, supportsReplyAdmin, supportsReplyLookup, supportsReplyNotification, supportsReplyRecordType, supportsReplySearchRecordType, supportsVisibleFederationModifier and TypeMethodDescriptionGets the supportedForumrecord types.Gets the supported forum search record types.Gets the supportedPostrecord types.Gets the supported post search record types.Gets the supportedReplyrecord types.Gets the supported reply search record types.booleanTests for the availability of a forum administrative service for creating and deleting forums.booleanTests if forum batch service is available.booleanTests for the availability of a forum hierarchy traversal service.booleanTests for the availability of a forum hierarchy design service.booleanTests for the availability of a forum lookup service.booleanTests for the availability of a forum notification service.booleanTests if querying forums is available.booleansupportsForumRecordType(Type forumRecordType) Tests if the givenForumrecord type is supported.booleanTests if searching for forums is available.booleansupportsForumSearchRecordType(Type forumSearchRecordType) Tests if the given forum search record type is supported.booleanTests for the availability of a post administrative service for creating and deleting posts.booleanTests if a post to forum lookup session is available.booleanTests if a post to forum assignment session is available.booleanTests for the availability of a post lookup service.booleanTests for the availability of a post notification service.booleanTests if querying posts is available.booleansupportsPostRecordType(Type postRecordType) Tests if the givenPostrecord type is supported.booleanTests if searching for posts is available.booleansupportsPostSearchRecordType(Type postSearchRecordType) Tests if the given post search record type is supported.booleanTests if a post smart foruming session is available.booleanTests if searching for replies is available.booleanTests for the availability of a reply lookup service.booleanTests if reply notification is available.booleansupportsReplyRecordType(Type replyRecordType) Tests if the givenReplyrecord type is supported.booleansupportsReplySearchRecordType(Type replySearchRecordType) Tests if the given reply search record type is supported.booleanTests if any post federation is exposed.Methods inherited from interface OsidProfile
getBranch, getBranchId, getDescription, getDisplayName, getId, getLocales, getProxyRecordTypes, getReleaseDate, getVersion, supportsJournalBranching, supportsJournalRollback, supportsOSIDVersion, supportsProxyRecordTypeModifier and TypeMethodDescriptionGets this service branch.Gets theBranch Idrepresenting this service branch.Gets a description of this service implementation.Gets a display name for this service implementation.getId()Gets an identifier for this service implementation.Gets the locales supported in this service.Gets the proxy recordTypessupported in this service.Gets the date this service implementation was released.Gets the version of this service implementation.booleanTest for support of a journal branching service.booleanTest for support of a journaling rollback service.booleansupportsOSIDVersion(Version version) Test for support of an OSID specification version.booleansupportsProxyRecordType(Type proxyRecordType) Test for support of a proxy type.Methods inherited from interface OsidProxyManager
closeMethods inherited from interface OsidProxyManager
changeBranch, initialize, rollbackServiceModifier and TypeMethodDescriptionvoidchangeBranch(Id branchId, Proxy proxy) Changes the service branch.voidinitialize(OsidRuntimeManager runtime) Initializes this manager.rollbackService(Date rollbackTime, Proxy proxy) Rolls back this service to a point in time.Methods inherited from interface Sourceable
getBranding, getBrandingIds, getLicense, getProvider, getProviderIdModifier and TypeMethodDescriptionGets a branding, such as an image or logo, expressed using theAssetinterface.Gets the branding assetIds.Gets the terms of usage.Gets theResourcerepresenting the provider.Gets theIdof the provider.
-
Method Details
-
getPostLookupSession
Gets theOsidSessionassociated with the post lookup service.- Parameters:
proxy- a proxy- Returns:
- a
PostLookupSession - Throws:
NullArgumentException-proxyisnullOperationFailedException- unable to complete requestUnimplementedException-supportsPostLookup()isfalse- Compliance:
optional- This method must be implemented if {@code supportsPostLookup()} is {@code true} .
-
getPostLookupSessionForForum
PostLookupSession getPostLookupSessionForForum(Id forumId, Proxy proxy) throws NotFoundException, OperationFailedException Gets theOsidSessionassociated with the post lookup service for the given forum.- Parameters:
forumId- theIdof theForumproxy- a proxy- Returns:
- a
PostLookupSession - Throws:
NotFoundException- noForumfound by the givenIdNullArgumentException-forumIdorproxyisnullOperationFailedException- unable to complete requestUnimplementedException-supportsPostLookup()orsupportsVisibleFederation()isfalse- Compliance:
optional- This method must be implemented if {@code supportsPostLookup()} and {@code supportsVisibleFederation()} are {@code true}
-
getPostQuerySession
Gets theOsidSessionassociated with the post query service.- Parameters:
proxy- a proxy- Returns:
- a
PostQuerySession - Throws:
NullArgumentException-proxyisnullOperationFailedException- unable to complete requestUnimplementedException-supportsPostQuery()isfalse- Compliance:
optional- This method must be implemented if {@code supportsPostQuery()} is {@code true} .
-
getPostQuerySessionForForum
PostQuerySession getPostQuerySessionForForum(Id forumId, Proxy proxy) throws NotFoundException, OperationFailedException Gets theOsidSessionassociated with the post query service for the given forum.- Parameters:
forumId- theIdof theForumproxy- a proxy- Returns:
- a
PostQuerySession - Throws:
NotFoundException- noPostfound by the givenIdNullArgumentException-forumIdorproxyisnullOperationFailedException- unable to complete requestUnimplementedException-supportsPostQuery()orsupportsVisibleFederation()isfalse- Compliance:
optional- This method must be implemented if {@code supportsPostQuery()} and {@code supportsVisibleFederation()} are {@code true}
-
getPostSearchSession
Gets theOsidSessionassociated with the post search service.- Parameters:
proxy- a proxy- Returns:
- a
PostSearchSession - Throws:
NullArgumentException-proxyisnullOperationFailedException- unable to complete requestUnimplementedException-supportsPostSearch()isfalse- Compliance:
optional- This method must be implemented if {@code supportsPostSearch()} is {@code true} .
-
getPostSearchSessionForForum
PostSearchSession getPostSearchSessionForForum(Id forumId, Proxy proxy) throws NotFoundException, OperationFailedException Gets theOsidSessionassociated with the post search service for the given forum.- Parameters:
forumId- theIdof theForumproxy- a proxy- Returns:
- a
PostSearchSession - Throws:
NotFoundException- noPostfound by the givenIdNullArgumentException-forumIdorproxyisnullOperationFailedException- unable to complete requestUnimplementedException-supportsPostSearch()orsupportsVisibleFederation()isfalse- Compliance:
optional- This method must be implemented if {@code supportsPostSearch()} and {@code supportsVisibleFederation()} are {@code true}
-
getPostAdminSession
Gets theOsidSessionassociated with the post administrative service.- Parameters:
proxy- a proxy- Returns:
- a
PostAdminSession - Throws:
NullArgumentException-proxyisnullOperationFailedException- unable to complete requestUnimplementedException-supportsPostAdmin()isfalse- Compliance:
optional- This method must be implemented if {@code supportsPostAdmin()} is {@code true} .
-
getPostAdminSessionForForum
PostAdminSession getPostAdminSessionForForum(Id forumId, Proxy proxy) throws NotFoundException, OperationFailedException Gets theOsidSessionassociated with the post administration service for the given forum.- Parameters:
forumId- theIdof theForumproxy- a proxy- Returns:
- a
PostAdminSession - Throws:
NotFoundException- noPostfound by the givenIdNullArgumentException-forumIdorproxyisnullOperationFailedException- unable to complete requestUnimplementedException-supportsPostAdmin()orsupportsVisibleFederation()isfalse- Compliance:
optional- This method must be implemented if {@code supportsPostAdmin()} and {@code supportsVisibleFederation()} are {@code true}
-
getPostNotificationSession
PostNotificationSession getPostNotificationSession(PostReceiver postReceiver, Proxy proxy) throws OperationFailedException Gets theOsidSessionassociated with the post notification service.- Parameters:
postReceiver- the receiverproxy- a proxy- Returns:
- a
PostNotificationSession - Throws:
NullArgumentException-postReceiverorproxyisnullOperationFailedException- unable to complete requestUnimplementedException-supportsPostNotification()isfalse- Compliance:
optional- This method must be implemented if {@code supportsPostNotification()} is {@code true} .
-
getPostNotificationSessionForForum
PostNotificationSession getPostNotificationSessionForForum(PostReceiver postReceiver, Id forumId, Proxy proxy) throws NotFoundException, OperationFailedException Gets theOsidSessionassociated with the post notification service for the given forum.- Parameters:
postReceiver- the receiverforumId- theIdof theForumproxy- a proxy- Returns:
- a
PostNotificationSession - Throws:
NotFoundException- noPostfound by the givenIdNullArgumentException-postReceiver, forumIdorproxyisnullOperationFailedException- unable to complete requestUnimplementedException-supportsPostNotification()orsupportsVisibleFederation()isfalse- Compliance:
optional- This method must be implemented if {@code supportsPostNotification()} and {@code supportsVisibleFederation()} are {@code true}
-
getPostForumSession
Gets the session for retrieving post to forum mappings.- Parameters:
proxy- a proxy- Returns:
- a
PostForumSession - Throws:
NullArgumentException-proxyisnullOperationFailedException- unable to complete requestUnimplementedException-supportsPostForum()isfalse- Compliance:
optional- This method must be implemented if {@code supportsPostForum()} is {@code true} .
-
getPostForumAssignmentSession
PostForumAssignmentSession getPostForumAssignmentSession(Proxy proxy) throws OperationFailedException Gets the session for assigning post to forum mappings.- Parameters:
proxy- a proxy- Returns:
- a
PostForumAssignmentSession - Throws:
NullArgumentException-proxyisnullOperationFailedException- unable to complete requestUnimplementedException-supportsPostForumAssignment()isfalse- Compliance:
optional- This method must be implemented if {@code supportsPostForumAssignment()} is {@code true} .
-
getPostSmartForumSession
PostSmartForumSession getPostSmartForumSession(Id forumId, Proxy proxy) throws NotFoundException, OperationFailedException Gets the session for managing dynamic post forums for the given forum.- Parameters:
forumId- theIdof a forumproxy- a proxy- Returns:
forumIdnot found- Throws:
NotFoundException-forumIdorproxyisnullNullArgumentException-forumIdorproxyisnullOperationFailedException- unable to complete requestUnimplementedException-supportsPostSmartForum()isfalse- Compliance:
optional- This method must be implemented if {@code supportsPostSmartForum()} is {@code true} .
-
getReplyLookupSession
Gets theOsidSessionassociated with the reply lookup service.- Parameters:
proxy- a proxy- Returns:
- a
ReplyLookupSession - Throws:
NullArgumentException-proxyisnullOperationFailedException- unable to complete requestUnimplementedException-supportsReplyLookup()isfalse- Compliance:
optional- This method must be implemented if {@code supportsReplyLookup()} is {@code true} .
-
getReplyLookupSessionForForum
ReplyLookupSession getReplyLookupSessionForForum(Id forumId, Proxy proxy) throws NotFoundException, OperationFailedException Gets theOsidSessionassociated with the reply lookup service for the given forum.- Parameters:
forumId- theIdof theForumproxy- a proxy- Returns:
- a
ReplyLookupSession - Throws:
NotFoundException- noForumfound by the givenIdNullArgumentException-forumIdorproxyisnullOperationFailedException- unable to complete requestUnimplementedException-supportsReplyLookup()orsupportsVisibleFederation()isfalse- Compliance:
optional- This method must be implemented if {@code supportsReplyLookup()} and {@code supportsVisibleFederation()} are {@code true}
-
getReplyAdminSession
Gets theOsidSessionassociated with the reply administration service.- Parameters:
proxy- a proxy- Returns:
- a
ReplyAdminSession - Throws:
NullArgumentException-proxyisnullOperationFailedException- unable to complete requestUnimplementedException-supportsReplyAdmin()isfalse- Compliance:
optional- This method must be implemented if {@code supportsReplyAdmin()} is {@code true} .
-
getReplyAdminSessionForForum
ReplyAdminSession getReplyAdminSessionForForum(Id forumId, Proxy proxy) throws NotFoundException, OperationFailedException Gets theOsidSessionassociated with the reply administration service for the given forum.- Parameters:
forumId- theIdof theForumproxy- a proxy- Returns:
- a
ReplyAdminSession - Throws:
NotFoundException- noForumfound by the givenIdNullArgumentException-forumIdorproxyisnullOperationFailedException- unable to complete requestUnimplementedException-supportsReplyAdmin()orsupportsVisibleFederation()isfalse- Compliance:
optional- This method must be implemented if {@code supportsReplyAdmin()} and {@code supportsVisibleFederation()} are {@code true}
-
getReplyNotificationSession
ReplyNotificationSession getReplyNotificationSession(ReplyReceiver replyReceiver, Proxy proxy) throws OperationFailedException Gets theOsidSessionassociated with the reply notification service.- Parameters:
replyReceiver- the receiverproxy- a proxy- Returns:
- a
ReplyNotificationSession - Throws:
NullArgumentException-replyReceiverorproxyisnullOperationFailedException- unable to complete requestUnimplementedException-supportsReplyNotification()isfalse- Compliance:
optional- This method must be implemented if {@code supportsReplyNotification()} is {@code true} .
-
getReplyNotificationSessionForForum
ReplyNotificationSession getReplyNotificationSessionForForum(ReplyReceiver replyReceiver, Id forumId, Proxy proxy) throws NotFoundException, OperationFailedException Gets theOsidSessionassociated with the reply notification service for the given forum.- Parameters:
replyReceiver- the receiverforumId- theIdof theForumproxy- a proxy- Returns:
- a
ReplyNotificationSession - Throws:
NotFoundException- noForumfound by the givenIdNullArgumentException-replyReceiver, forumId, orproxyisnullOperationFailedException- unable to complete requestUnimplementedException-supportsReplyNotification()orsupportsVisibleFederation()isfalse- Compliance:
optional- This method must be implemented if {@code supportsReplyNotification()} and {@code supportsVisibleFederation()} are {@code true}
-
getForumLookupSession
Gets theOsidSessionassociated with the forum lookup service.- Parameters:
proxy- a proxy- Returns:
- a
ForumLookupSession - Throws:
NullArgumentException-proxyisnullOperationFailedException- unable to complete requestUnimplementedException-supportsForumLookup()isfalse- Compliance:
optional- This method must be implemented if {@code supportsForumLookup()} is {@code true} .
-
getForumQuerySession
Gets theOsidSessionassociated with the forum query service.- Parameters:
proxy- a proxy- Returns:
- a
ForumQuerySession - Throws:
NullArgumentException-proxyisnullOperationFailedException- unable to complete requestUnimplementedException-supportsForumQuery()isfalse- Compliance:
optional- This method must be implemented if {@code supportsForumQuery()} is {@code true} .
-
getForumSearchSession
Gets theOsidSessionassociated with the forum search service.- Parameters:
proxy- a proxy- Returns:
- a
ForumSearchSession - Throws:
NullArgumentException-proxyisnullOperationFailedException- unable to complete requestUnimplementedException-supportsForumSearch()isfalse- Compliance:
optional- This method must be implemented if {@code supportsForumSearch()} is {@code true} .
-
getForumAdminSession
Gets theOsidSessionassociated with the forum administrative service.- Parameters:
proxy- a proxy- Returns:
- a
ForumAdminSession - Throws:
NullArgumentException-proxyisnullOperationFailedException- unable to complete requestUnimplementedException-supportsForumAdmin()isfalse- Compliance:
optional- This method must be implemented if {@code supportsForumAdmin()} is {@code true} .
-
getForumNotificationSession
ForumNotificationSession getForumNotificationSession(ForumReceiver forumReceiver, Proxy proxy) throws OperationFailedException Gets theOsidSessionassociated with the forum notification service.- Parameters:
forumReceiver- the receiverproxy- a proxy- Returns:
- a
ForumNotificationSession - Throws:
NullArgumentException-forumReceiverorproxyisnullOperationFailedException- unable to complete requestUnimplementedException-supportsForumNotification()isfalse- Compliance:
optional- This method must be implemented if {@code supportsForumNotification()} is {@code true} .
-
getForumHierarchySession
Gets theOsidSessionassociated with the forum hierarchy service.- Parameters:
proxy- a proxy- Returns:
- a
ForumHierarchySession - Throws:
NullArgumentException-proxyisnullOperationFailedException- unable to complete requestUnimplementedException-supportsForumHierarchy()isfalse- Compliance:
optional- This method must be implemented if {@code supportsForumHierarchy()} is {@code true} .
-
getForumHierarchyDesignSession
ForumHierarchyDesignSession getForumHierarchyDesignSession(Proxy proxy) throws OperationFailedException Gets theOsidSessionassociated with the forum hierarchy design service.- Parameters:
proxy- a proxy- Returns:
- a
ForumHierarchyDesignSession - Throws:
NullArgumentException-proxyisnullOperationFailedException- unable to complete requestUnimplementedException-supportsForumHierarchyDesign()isfalse- Compliance:
optional- This method must be implemented if {@code supportsForumHierarchyDesign()} is {@code true} .
-
getForumBatchProxyManager
Gets aForumBatchProxyManager.- Returns:
- a
ForumBatchProxyManager - Throws:
OperationFailedException- unable to complete requestUnimplementedException-supportsForumBatch()isfalse- Compliance:
optional- This method must be implemented if {@code supportsForumBatch()} is {@code true} .
-