public interface TodoChecklistSession extends OsidSession
This session provides methods to retrieve Todo
to
Checklist
mappings. A Todo
may appear in multiple
Checklists.
Each Checklist
may have its own
authorizations governing who is allowed to look at it.
This lookup session defines several views:
Modifier and Type | Method and Description |
---|---|
boolean |
canLookupTodoChecklistMappings()
Tests if this user can perform lookups of todo/checklist mappings.
|
IdList |
getChecklistIdsByTodo(Id todoId)
Gets the list of
Checklist Ids mapped to
a Todo. |
ChecklistList |
getChecklistsByTodo(Id todoId)
Gets the list of
Checklist objects mapped to a
Todo. |
IdList |
getTodoIdsByChecklist(Id checklistId)
Gets the list of Todo Ids associated with a
Checklist. |
IdList |
getTodoIdsByChecklists(IdList checklistIds)
Gets the list of
Todo Ids corresponding to a list of
Checklist objects. |
TodoList |
getTodosByChecklist(Id checklistId)
Gets the list of
Todos associated with a
Checklist. |
TodoList |
getTodosByChecklists(IdList checklistIds)
Gets the list of
Todos corresponding to a list of
Checklists. |
void |
useComparativeChecklistView()
The returns from the lookup methods may omit or translate elements
based on this session, such as authorization, and not result in an
error.
|
void |
usePlenaryChecklistView()
A complete view of the
Todo and Checklist
returns is desired. |
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
boolean canLookupTodoChecklistMappings()
PERMISSION_DENIED.
This is intendedas
a hint to an application that may opt not to offer lookup operations
to unauthorized users. false
if looking up mappings is not authorized,
true
otherwisemandatory
- This method must be implemented. void useComparativeChecklistView()
mandatory
- This method is must be implemented. void usePlenaryChecklistView()
Todo
and Checklist
returns is desired. Methods will return what is requested or
result in an error. This view is used when greater precision is
desired at the expense of interoperability.mandatory
- This method is must be implemented. IdList getTodoIdsByChecklist(Id checklistId) throws NotFoundException, OperationFailedException, PermissionDeniedException
Checklist.
checklistId
- Id
of a Checklist.
Ids
NotFoundException
- checklistId
is not
foundNullArgumentException
- checklistId
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. TodoList getTodosByChecklist(Id checklistId) throws NotFoundException, OperationFailedException, PermissionDeniedException
Todos
associated with a
Checklist.
checklistId
- Id
of a Checklist
NotFoundException
- checklistId
is not
foundNullArgumentException
- checklistId
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. IdList getTodoIdsByChecklists(IdList checklistIds) throws OperationFailedException, PermissionDeniedException
Todo Ids
corresponding to a list of
Checklist
objects.checklistIds
- list of checklist Ids
Ids
NullArgumentException
- checklistIds
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. TodoList getTodosByChecklists(IdList checklistIds) throws OperationFailedException, PermissionDeniedException
Todos
corresponding to a list of
Checklists.
checklistIds
- list of checklist Ids
NullArgumentException
- checklistIds
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. IdList getChecklistIdsByTodo(Id todoId) throws NotFoundException, OperationFailedException, PermissionDeniedException
Checklist
Ids
mapped to
a Todo.
todoId
- Id
of a Todo
Ids
NotFoundException
- todoId
is not foundNullArgumentException
- todoId
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. ChecklistList getChecklistsByTodo(Id todoId) throws NotFoundException, OperationFailedException, PermissionDeniedException
Checklist
objects mapped to a
Todo.
todoId
- Id
of a Todo
NotFoundException
- todoId
is not foundNullArgumentException
- todoId
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented.