public interface TodoQuerySession extends OsidSession
This session provides methods for searching Todo
objects. The search query is constructed using the TodoQuery.
The todo record Type
also specifies the record for
the todo query.
This session defines views that offer differing behaviors for searching.
Todos may have a query record indicated by their respective record
types. The query record is accessed via the TodoQuery.
The
returns in this session may not be cast directly to these interfaces.
Modifier and Type | Method and Description |
---|---|
boolean |
canSearchTodos()
Tests if this user can perform todo searches.
|
Checklist |
getChecklist()
Gets the
Checklist associated with this session. |
Id |
getChecklistId()
Gets the
Checklist Id associated with
this session. |
TodoQuery |
getTodoQuery()
Gets a todo query.
|
TodoList |
getTodosByQuery(TodoQuery todoQuery)
Gets a list of todos matching the given search.
|
void |
useFederatedChecklistView()
Federates the view for methods in this session.
|
void |
useIsolatedChecklistView()
Isolates the view for methods in this session.
|
void |
useSequesteredTodoView()
The returns from the search methods omit sequestered todos.
|
void |
useUnsequesteredTodoView()
All todos are returned including sequestered todos.
|
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
Id getChecklistId()
Checklist
Id
associated with
this session. Checklist Id
associated with this sessionmandatory
- This method must be implemented. Checklist getChecklist() throws OperationFailedException, PermissionDeniedException
Checklist
associated with this session.OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. boolean canSearchTodos()
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 useFederatedChecklistView()
mandatory
- This method is must be implemented. void useIsolatedChecklistView()
mandatory
- This method is must be implemented. void useSequesteredTodoView()
mandatory
- This method is must be implemented. void useUnsequesteredTodoView()
mandatory
- This method is must be implemented. TodoQuery getTodoQuery()
mandatory
- This method must be implemented. TodoList getTodosByQuery(TodoQuery todoQuery) throws OperationFailedException, PermissionDeniedException
todoQuery
- the search query array TodoList
NullArgumentException
- todoQuery
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failureUnsupportedException
- todoQuery
is not
of this servicemandatory
- This method must be implemented.