public interface TodoLookupSession extends OsidSession
This session defines methods for retrieving todos.
This lookup session defines several views:
TodoAdminSession.
The methods useFederatedChecklistView()
and
useIsolatedChecklistView()
behave as a radio group and one should
be selected before invoking any lookup methods.
Modifier and Type | Method and Description |
---|---|
boolean |
canLookupTodos()
Tests if this user can examine this checklist.
|
Checklist |
getChecklist()
Gets the
Checklist associated with this session. |
Id |
getChecklistId()
Gets the
Checklist Id associated with
this session. |
Todo |
getTodo(Id todoId)
Gets the
Todo specified by its Id. |
TodoList |
getTodos()
Gets all todos.
|
TodoList |
getTodosByDependency(Id dependencyTodoId)
Gets a
TodoList of todos dependent upon the given todo. |
TodoList |
getTodosByDueDate(DateTime from,
DateTime to)
Gets a
TodoList with a due date within the given date
range inclusive . |
TodoList |
getTodosByGenusType(Type todoGenusType)
Gets a
TodoList corresponding to the given todo genus
Type which does not include todos of genus types
derived from the specified Type. |
TodoList |
getTodosByIds(IdList todoIds)
Gets a
TodoList corresponding to the given
IdList. |
TodoList |
getTodosByParentGenusType(Type todoGenusType)
Gets a
TodoList corresponding to the given todo genus
Type and include any additional todos with genus types
derived from the specified Type. |
TodoList |
getTodosByPriority(Type priorityType)
Gets a
TodoList at the given priority Type
or higher. |
TodoList |
getTodosByRecordType(Type todoRecordType)
Gets a
TodoList containing the given todo record
Type. |
TodoList |
getTodosOnDate(DateTime from,
DateTime to)
Gets a
TodoList with starting effective during the
entire given date range inclusive but not confined to the date range. |
void |
useAnyEffectiveTodoView()
All todos of any effective dates are returned by all methods in this
session.
|
void |
useComparativeTodoView()
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 |
useEffectiveTodoView()
Only todos whose effective dates are current are returned by methods
in this session.
|
void |
useFederatedChecklistView()
Federates the view for methods in this session.
|
void |
useIsolatedChecklistView()
Isolates the view for methods in this session.
|
void |
usePlenaryTodoView()
A complete view of the
Todo returns is desired. |
void |
useSequesteredTodoView()
The returns from the lookup 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 canLookupTodos()
PERMISSION_DENIED.
This is intended as a hint to an
application that may opt not to offer these operations. false
if checklist reading methods are not
authorized, true
otherwisemandatory
- This method must be implemented. void useComparativeTodoView()
mandatory
- This method is must be implemented. void usePlenaryTodoView()
Todo
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. void useFederatedChecklistView()
mandatory
- This method is must be implemented. void useIsolatedChecklistView()
mandatory
- This method is must be implemented. void useEffectiveTodoView()
mandatory
- This method is must be implemented. void useAnyEffectiveTodoView()
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. Todo getTodo(Id todoId) throws NotFoundException, OperationFailedException, PermissionDeniedException
Todo
specified by its Id.
In plenary mode, the exact Id
is found
or a NOT_FOUND
results. Otherwise, the returned
Todo
may have a different Id
than requested,
such as the case where a duplicate Id
was assigned to a
Todo
and retained for compatibility.
In effective mode, todos are returned that are currently effective. In
any effective mode, effective todos and those currently expired are
returned.
In sequestered mode, no sequestered todos are returned. In
unsequestered mode, all todos are returned.todoId
- the Id
of the Todo
to
retrieve Todo
NotFoundException
- no Todo
found with
the given Id
NullArgumentException
- todoId
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. TodoList getTodosByIds(IdList todoIds) throws NotFoundException, OperationFailedException, PermissionDeniedException
TodoList
corresponding to the given
IdList.
In plenary mode, the returned list contains all of the
todos specified in the Id
list, in the order of the
list, including duplicates, or an error results if an Id
in the supplied list is not found or inaccessible. Otherwise,
inaccessible todos may be omitted from the list and may present the
elements in any order including returning a unique set.
In effective mode, todos are returned that are currently effective. In
any effective mode, effective todos and those currently expired are
returned.
In sequestered mode, no sequestered todos are returned. In
unsequestered mode, all todos are returned.todoIds
- the list of Ids
to retrieve Todo list
NotFoundException
- an Id was
not foundNullArgumentException
- todoIds
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. TodoList getTodosByGenusType(Type todoGenusType) throws OperationFailedException, PermissionDeniedException
TodoList
corresponding to the given todo genus
Type
which does not include todos of genus types
derived from the specified Type.
In plenary mode, the returned list contains all known
todos or an error results. Otherwise, the returned list may contain
only those todos that are accessible through this session.
In effective mode, todos are returned that are currently effective. In
any effective mode, effective todos and those currently expired are
returned.
In sequestered mode, no sequestered todos are returned. In
unsequestered mode, all todos are returned.todoGenusType
- a todo genus type Todo
listNullArgumentException
- todoGenusType
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. TodoList getTodosByParentGenusType(Type todoGenusType) throws OperationFailedException, PermissionDeniedException
TodoList
corresponding to the given todo genus
Type
and include any additional todos with genus types
derived from the specified Type.
In plenary mode, the returned list contains all known
todos or an error results. Otherwise, the returned list may contain
only those todos that are accessible through this session.
In effective mode, todos are returned that are currently effective. In
any effective mode, effective todos and those currently expired are
returned.
In sequestered mode, no sequestered todos are returned. In
unsequestered mode, all todos are returned.todoGenusType
- a todo genus type Todo
listNullArgumentException
- todoGenusType
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. TodoList getTodosByRecordType(Type todoRecordType) throws OperationFailedException, PermissionDeniedException
TodoList
containing the given todo record
Type.
In plenary mode, the returned list contains all known
todos or an error results. Otherwise, the returned list may contain
only those todos that are accessible through this session.
In effective mode, todos are returned that are currently effective. In
any effective mode, effective todos and those currently expired are
returned.todoRecordType
- a todo record type Todo
listNullArgumentException
- todoRecordType
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. TodoList getTodosOnDate(DateTime from, DateTime to) throws OperationFailedException, PermissionDeniedException
TodoList
with starting effective during the
entire given date range inclusive but not confined to the date range.
This method return sthe same results in either effective status mode.
In plenary mode, the returned list contains all known todos or an
error results. Otherwise, the returned list may contain only those
todos that are accessible through this session.
In effective mode, todos are returned that are currently effective. In
any effective mode, effective todos and those currently expired are
returned.
In sequestered mode, no sequestered todos are returned. In
unsequestered mode, all todos are returned.from
- starting dateto
- ending date Todo
listInvalidArgumentException
- from
is
greater than to
NullArgumentException
- from
or
to
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. TodoList getTodosByPriority(Type priorityType) throws OperationFailedException, PermissionDeniedException
TodoList
at the given priority Type
or higher.
In plenary mode, the returned list contains all known todos or an
error results. Otherwise, the returned list may contain only those
todos that are accessible through this session.
In effective mode, todos are returned that are currently effective. In
any effective mode, effective todos and those currently expired are
returned.priorityType
- a priority type Todo
listNullArgumentException
- priorityType
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. TodoList getTodosByDueDate(DateTime from, DateTime to) throws OperationFailedException, PermissionDeniedException
TodoList
with a due date within the given date
range inclusive .
In plenary mode, the returned list contains all known
todos or an error results. Otherwise, the returned list may contain
only those todos that are accessible through this session.
In effective mode, todos are returned that are currently effective. In
any effective mode, effective todos and those currently expired are
returned.
In sequestered mode, no sequestered todos are returned. In
unsequestered mode, all todos are returned.from
- starting dateto
- ending date Todo
listInvalidArgumentException
- from
is
greater than to
NullArgumentException
- from
or
to
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. TodoList getTodosByDependency(Id dependencyTodoId) throws OperationFailedException, PermissionDeniedException
TodoList
of todos dependent upon the given todo.
In plenary mode, the returned list contains all known todos or an
error results. Otherwise, the returned list may contain only those
todos that are accessible through this session.
In effective mode, todos are returned that are currently effective. In
any effective mode, effective todos and those currently expired are
returned.
In sequestered mode, no sequestered todos are returned. In
unsequestered mode, all todos are returned.dependencyTodoId
- a todo Todo
listNullArgumentException
- dependencyTodoId
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. TodoList getTodos() throws OperationFailedException, PermissionDeniedException
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented.