public interface CommentQuerySession extends OsidSession
This session provides methods for searching Comment
objects. The search query is constructed using the CommentQuery.
The book record Type
also specifies the record for
the book query.
Comments may have a query record indicated by their respective record
types. The query record is accessed via the CommentQuery.
The returns in this session may not be cast directly to these interfaces.
Modifier and Type | Method and Description |
---|---|
boolean |
canSearchComments()
Tests if this user can perform comment searches.
|
Book |
getBook()
Gets the
Book associated with this session. |
Id |
getBookId()
Gets the
Book Id associated with this
session. |
CommentQuery |
getCommentQuery()
Gets a comment query.
|
CommentList |
getCommentsByQuery(CommentQuery commentQuery)
Gets a list of comments matching the given search.
|
void |
useFederatedBookView()
Federates the view for methods in this session.
|
void |
useIsolatedBookView()
Isolates the view for methods in this session.
|
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
Id getBookId()
Book
Id
associated with this
session. Book Id
associated with this sessionmandatory
- This method must be implemented. Book getBook() throws OperationFailedException, PermissionDeniedException
Book
associated with this session.OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. boolean canSearchComments()
PERMISSION_DENIED.
This is intended as a hint to an
application that may not wish to offer search operations to
unauthorized users. false
if search methods are not authorized,
true
otherwisemandatory
- This method must be implemented. void useFederatedBookView()
mandatory
- This method is must be implemented. void useIsolatedBookView()
mandatory
- This method is must be implemented. CommentQuery getCommentQuery()
mandatory
- This method must be implemented. CommentList getCommentsByQuery(CommentQuery commentQuery) throws OperationFailedException, PermissionDeniedException
commentQuery
- the search query array CommentList
NullArgumentException
- commentQuery
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failureUnsupportedException
- commentQuery
is
not of this servicemandatory
- This method must be implemented.