OSID Logo
OSID Specifications
commenting package
Version 3.0.0
Release Candidate Preview
Interfaceosid.commenting.CommentingProxyManager
Implementsosid.OsidProxyManager
osid.commenting.CommentingProfile
Description

The commenting manager provides access to commenting 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:

  • CommentLookupSession: a session to lookup comments
  • RatingLookupSession: a session to lookup comments
  • CommentQuerySession: a session to query comments
  • CommentSearchSession: a session to search comments
  • CommentAdminSession: a session to manage comments
  • CommentNotificationSession: a session to subscribe to notifications of comment changes
  • CommentBookSession: a session for looking up comment and book mappings
  • CommentBookAssignmentSession: a session for managing comment and book mappings
  • CommentSmartBookSession: a session to manage dynamic comment books
  • BookLookupSession: a session to retrieve books
  • BookQuerySession: a session to query books
  • BookSearchSession: a session to search for books
  • BookAdminSession: a session to create, update and delete books
  • BookNotificationSession: a session to receive notifications for changes in books
  • BookHierarchyTraversalSession: a session to traverse hierarchies of books
  • BookHierarchyDesignSession: a session to manage hierarchies of books

The commenting manager also provides a profile for determing the supported search types supported by this service.

MethodgetCommentLookupSession
Description

Gets the OsidSession associated with the comment lookup service.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.commenting.CommentLookupSessiona CommentLookupSession
ErrorsNULL_ARGUMENT proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsCommentLookup() is false
ComplianceoptionalThis method must be implemented if supportsCommentLookup() is true.
MethodgetCommentLookupSessionForBook
Description

Gets the OsidSession associated with the comment lookup service for the given book.

Parametersosid.id.IdbookIdthe Id of the Book
osid.proxy.Proxyproxya proxy
Returnosid.commenting.CommentLookupSessiona CommentLookupSession
ErrorsNOT_FOUNDno Book found by the given Id
NULL_ARGUMENT bookId or proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsCommentLookup() or supportsVisibleFederation() is false
ComplianceoptionalThis method must be implemented if supportsCommentLookup() and supportsVisibleFederation() are true
MethodgetRatingLookupSession
Description

Gets the OsidSession associated with the rating lookup service.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.commenting.RatingLookupSessiona RatingLookupSession
ErrorsNULL_ARGUMENT proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsRatingLookup() is false
ComplianceoptionalThis method must be implemented if supportsRatingLookup() is true.
MethodgetRatingLookupSessionForBook
Description

Gets the OsidSession associated with the rating lookup service for the given book.

Parametersosid.id.IdbookIdthe Id of the Book
osid.proxy.Proxyproxya proxy
Returnosid.commenting.RatingLookupSessiona RatingLookupSession
ErrorsNOT_FOUNDno Book found by the given Id
NULL_ARGUMENT bookId or proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsRatingLookup() or supportsVisibleFederation() is false
ComplianceoptionalThis method must be implemented if supportsRatingLookup() and supportsVisibleFederation() are true
MethodgetCommentQuerySession
Description

Gets the OsidSession associated with the comment query service.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.commenting.CommentQuerySessiona CommentQuerySession
ErrorsNULL_ARGUMENT proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsCommentQuery() is false
ComplianceoptionalThis method must be implemented if supportsCommentQuery() is true.
MethodgetCommentQuerySessionForBook
Description

Gets the OsidSession associated with the comment query service for the given book.

Parametersosid.id.IdbookIdthe Id of the Book
osid.proxy.Proxyproxya proxy
Returnosid.commenting.CommentQuerySessiona CommentQuerySession
ErrorsNOT_FOUNDno Comment found by the given Id
NULL_ARGUMENT bookId or proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsCommentQuery() or supportsVisibleFederation() is false
ComplianceoptionalThis method must be implemented if supportsCommentQuery() and supportsVisibleFederation() are true
MethodgetCommentSearchSession
Description

Gets the OsidSession associated with the comment search service.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.commenting.CommentSearchSessiona CommentSearchSession
ErrorsNULL_ARGUMENT proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsCommentSearch() is false
ComplianceoptionalThis method must be implemented if supportsCommentSearch() is true.
MethodgetCommentSearchSessionForBook
Description

Gets the OsidSession associated with the comment search service for the given book.

Parametersosid.id.IdbookIdthe Id of the Book
osid.proxy.Proxyproxya proxy
Returnosid.commenting.CommentSearchSessiona CommentSearchSession
ErrorsNOT_FOUNDno Comment found by the given Id
NULL_ARGUMENT bookId or proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsCommentSearch() or supportsVisibleFederation() is false
ComplianceoptionalThis method must be implemented if supportsCommentSearch() and supportsVisibleFederation() are true
MethodgetCommentAdminSession
Description

Gets the OsidSession associated with the comment administration service.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.commenting.CommentAdminSessiona CommentAdminSession
ErrorsNULL_ARGUMENT proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsCommentAdmin() is false
ComplianceoptionalThis method must be implemented if supportsCommentAdmin() is true.
MethodgetCommentAdminSessionForBook
Description

Gets the OsidSession associated with the comment administration service for the given book.

Parametersosid.id.IdbookIdthe Id of the Book
osid.proxy.Proxyproxya proxy
Returnosid.commenting.CommentAdminSessiona CommentAdminSession
ErrorsNOT_FOUNDno Comment found by the given Id
NULL_ARGUMENT bookId or proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsCommentAdmin() or supportsVisibleFederation() is false
ComplianceoptionalThis method must be implemented if supportsCommentAdmin() and supportsVisibleFederation() are true
MethodgetCommentNotificationSession
Description

Gets the OsidSession associated with the comment notification service.

Parametersosid.commenting.CommentReceivercommentReceiverthe receiver
osid.proxy.Proxyproxya proxy
Returnosid.commenting.CommentNotificationSessiona CommentNotificationSession
ErrorsNULL_ARGUMENT commentReceiver or proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsCommentNotification() is false
ComplianceoptionalThis method must be implemented if supportsCommentNotification() is true.
MethodgetCommentNotificationSessionForBook
Description

Gets the OsidSession associated with the comment notification service for the given book.

Parametersosid.commenting.CommentReceivercommentReceiverthe receiver
osid.id.IdbookIdthe Id of the Book
osid.proxy.Proxyproxya proxy
Returnosid.commenting.CommentNotificationSessiona CommentNotificationSession
ErrorsNOT_FOUNDno Comment found by the given Id
NULL_ARGUMENT commentReceiver, bookId or proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsCommentNotification() or supportsVisibleFederation() is false
ComplianceoptionalThis method must be implemented if supportsCommentNotification() and supportsVisibleFederation() are true
MethodgetCommentBookSession
Description

Gets the session for retrieving comment to book mappings.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.commenting.CommentBookSessiona CommentBookSession
ErrorsNULL_ARGUMENT proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsCommentBook() is false
ComplianceoptionalThis method must be implemented if supportsCommentBook() is true.
MethodgetCommentBookAssignmentSession
Description

Gets the session for assigning comment to book mappings.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.commenting.CommentBookAssignmentSessiona CommentBookAssignmentSession
ErrorsNULL_ARGUMENT proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsCommentBookAssignment() is false
ComplianceoptionalThis method must be implemented if supportsCommentBookAssignment() is true.
MethodgetCommentSmartBookSession
Description

Gets the session for managing dynamic comment books for the given book.

Parametersosid.id.IdbookIdthe Id of a book
osid.proxy.Proxyproxya proxy
Returnosid.commenting.CommentSmartBookSession bookId not found
ErrorsNOT_FOUND bookId or proxy is null
NULL_ARGUMENT bookId or proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsCommentSmartBook() is false
ComplianceoptionalThis method must be implemented if supportsCommentSmartBook() is true.
MethodgetBookLookupSession
Description

Gets the OsidSession associated with the book lookup service.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.commenting.BookLookupSessiona BookLookupSession
ErrorsNULL_ARGUMENT proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsBookLookup() is false
ComplianceoptionalThis method must be implemented if supportsBookLookup() is true.
MethodgetBookQuerySession
Description

Gets the OsidSession associated with the book query service.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.commenting.BookQuerySessiona BookQuerySession
ErrorsNULL_ARGUMENT proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsBookQueryh() is false
ComplianceoptionalThis method must be implemented if supportsBookQuery() is true.
MethodgetBookSearchSession
Description

Gets the OsidSession associated with the book search service.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.commenting.BookSearchSessiona BookSearchSession
ErrorsNULL_ARGUMENT proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsBookSearch() is false
ComplianceoptionalThis method must be implemented if supportsBookSearch() is true.
MethodgetBookAdminSession
Description

Gets the OsidSession associated with the book administrative service.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.commenting.BookAdminSessiona BookAdminSession
ErrorsNULL_ARGUMENT proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsBookAdmin() is false
ComplianceoptionalThis method must be implemented if supportsBookAdmin() is true.
MethodgetBookNotificationSession
Description

Gets the OsidSession associated with the book notification service.

Parametersosid.commenting.BookReceiverbookReceiverthe receiver
osid.proxy.Proxyproxya proxy
Returnosid.commenting.BookNotificationSessiona BookNotificationSession
ErrorsNULL_ARGUMENT bookReceiver or proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsBookNotification() is false
ComplianceoptionalThis method must be implemented if supportsBookNotification() is true.
MethodgetBookHierarchySession
Description

Gets the OsidSession associated with the book hierarchy service.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.commenting.BookHierarchySessiona BookHierarchySession
ErrorsNULL_ARGUMENT proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsBookHierarchy() is false
ComplianceoptionalThis method must be implemented if supportsBookHierarchy() is true.
MethodgetBookHierarchyDesignSession
Description

Gets the OsidSession associated with the book hierarchy design service.

Parametersosid.proxy.Proxyproxya proxy
Returnosid.commenting.BookHierarchyDesignSessiona BookHierarchyDesignSession
ErrorsNULL_ARGUMENT proxy is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsBookHierarchyDesign() is false
ComplianceoptionalThis method must be implemented if supportsBookHierarchyDesign() is true.
MethodgetCommentingBatchProxyManager
Description

Gets a CommentingBatchProxyManager.

Returnosid.commenting.batch.CommentingBatchProxyManagera CommentingBatchProxyManager
ErrorsOPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsCommentingBatch() is false
ComplianceoptionalThis method must be implemented if supportsCommentingBatch() is true.