public interface ResultLookupSession extends OsidSession
This session defines methods for retrieving results.
This lookup session defines several views:
ResultAdminSession.
The methods useFederatedCatalogueView()
and
useIsolatedCatalogueView()
behave as a radio group and one should
be selected before invoking any lookup methods.
Modifier and Type | Method and Description |
---|---|
boolean |
canLookupResults()
Tests if this user can examine this catalogue.
|
Catalogue |
getCatalogue()
Gets the
Catalogue associated with this session. |
Id |
getCatalogueId()
Gets the
Catalogue Id associated with
this session. |
Result |
getResult(Id resultId)
Gets the
Result specified by its Id. |
ResultList |
getResults()
Gets all results.
|
ResultList |
getResultsByGenusType(Type resultGenusType)
Gets an
ResultList corresponding to the given result
genus Type which does not include results of types
derived from the specified Type. |
ResultList |
getResultsByGenusTypeForParticipant(Id participantId,
Type resultGenusType)
Gets an
ResultList for the given participant Id. |
ResultList |
getResultsByGenusTypeForParticipantOnDate(Id participantId,
Type resultGenusType,
DateTime from,
DateTime to)
Gets a list of results for a participant and effective during the
entire given date range inclusive but not confined to the date range.
|
ResultList |
getResultsByGenusTypeOnDate(Type resultGenusType,
DateTime from,
DateTime to)
Gets an
ResultList by genus type effective during the
entire given date range inclusive but not confined to the date range. |
ResultList |
getResultsByIds(IdList resultIds)
Gets an
ResultList corresponding to the given
IdList. |
ResultList |
getResultsByParentGenusType(Type resultGenusType)
Gets an
ResultList corresponding to the given result
genus Type and include any additional results with
genus types derived from the specified Type. |
ResultList |
getResultsByRecordType(Type resultRecordType)
Gets an
ResultList containing the given result record
Type. |
ResultList |
getResultsForParticipant(Id participantId)
Gets an
ResultList for the given participant Id. |
ResultList |
getResultsForParticipantOnDate(Id participantId,
DateTime from,
DateTime to)
Gets a list of results for a participant and effective during the
entire given date range inclusive but not confined to the date range.
|
ResultList |
getResultsOnDate(DateTime from,
DateTime to)
Gets an
ResultList effective during the entire given
date range inclusive but not confined to the date range. |
void |
useAnyEffectiveResultView()
All results of any effective dates are returned by methods in this
session.
|
void |
useComparativeResultView()
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 |
useEffectiveResultView()
Only results whose effective dates are current are returned by methods
in this session.
|
void |
useFederatedCatalogueView()
Federates the view for methods in this session.
|
void |
useIsolatedCatalogueView()
Isolates the view for methods in this session.
|
void |
usePlenaryResultView()
A complete view of the
Result returns is desired. |
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
Id getCatalogueId()
Catalogue
Id
associated with
this session. Catalogue Id
associated with this sessionmandatory
- This method must be implemented. Catalogue getCatalogue() throws OperationFailedException, PermissionDeniedException
Catalogue
associated with this session.OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. boolean canLookupResults()
PERMISSION_DENIED.
This is intended as a hint to an
application that may opt not to offer these operations. false
if catalogue reading methods are not
authorized, true
otherwisemandatory
- This method must be implemented. void useComparativeResultView()
mandatory
- This method is must be implemented. void usePlenaryResultView()
Result
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 useFederatedCatalogueView()
mandatory
- This method is must be implemented. void useIsolatedCatalogueView()
mandatory
- This method is must be implemented. void useEffectiveResultView()
mandatory
- This method is must be implemented. void useAnyEffectiveResultView()
mandatory
- This method is must be implemented. Result getResult(Id resultId) throws NotFoundException, OperationFailedException, PermissionDeniedException
Result
specified by its Id.
In plenary mode, the exact Id
is found
or a NOT_FOUND
results. Otherwise, the returned
Result
may have a different Id
than requested,
such as the case where a duplicate Id
was assigned to
an Result
and retained for compatibility.
In effective mode, results are returned that are currently effective.
In any effective mode, effective results and those currently expired
are returned.resultId
- the Id
of the Result
to
retrieve Result
NotFoundException
- no Result
found with
the given Id
NullArgumentException
- resultId
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. ResultList getResultsByIds(IdList resultIds) throws NotFoundException, OperationFailedException, PermissionDeniedException
ResultList
corresponding to the given
IdList.
In plenary mode, the returned list contains all of the
results 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 results may be omitted from the list and may present the
elements in any order including returning a unique set.
In effective mode, results are returned that are currently effective.
In any effective mode, effective results and those currently expired
are returned.resultIds
- the list of Ids
to retrieve Result list
NotFoundException
- an Id was
not foundNullArgumentException
- resultIds
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. ResultList getResultsByGenusType(Type resultGenusType) throws OperationFailedException, PermissionDeniedException
ResultList
corresponding to the given result
genus Type
which does not include results of types
derived from the specified Type.
In plenary mode, the returned list contains all known
results or an error results. Otherwise, the returned list may contain
only those results that are accessible through this session.
In effective mode, results are returned that are currently effective.
In any effective mode, effective results and those currently expired
are returned.resultGenusType
- an results genus type Result list
NullArgumentException
- resultGenusType
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. ResultList getResultsByParentGenusType(Type resultGenusType) throws OperationFailedException, PermissionDeniedException
ResultList
corresponding to the given result
genus Type
and include any additional results with
genus types derived from the specified Type.
In plenary mode, the returned list contains all known
results or an error results. Otherwise, the returned list may contain
only those results that are accessible through this session.
In effective mode, results are returned that are currently effective.
In any effective mode, effective results and those currently expired
are returned.resultGenusType
- a result genus type Result list
NullArgumentException
- resultGenusType
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. ResultList getResultsByRecordType(Type resultRecordType) throws OperationFailedException, PermissionDeniedException
ResultList
containing the given result record
Type.
In plenary mode, the returned list contains all known results or an
error results. Otherwise, the returned list may contain only those
results that are accessible through this session.
In effective mode, results are returned that are currently effective.
In any effective mode, effective results and those currently expired
are returned.resultRecordType
- an result record type ResultList
NullArgumentException
- resultRecordType
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. ResultList getResultsOnDate(DateTime from, DateTime to) throws OperationFailedException, PermissionDeniedException
ResultList
effective during the entire given
date range inclusive but not confined to the date range.
In plenary mode, the returned list contains all known results or an
error results. Otherwise, the returned list may contain only those
results that are accessible through this session.
In effective mode, results are returned that are currently effective.
In any effective mode, effective results and those currently expired
are returned.from
- start of date rangeto
- end of date range ResultList
InvalidArgumentException
- from
is
greater than to
NullArgumentException
- from or to
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. ResultList getResultsByGenusTypeOnDate(Type resultGenusType, DateTime from, DateTime to) throws OperationFailedException, PermissionDeniedException
ResultList
by genus type effective during the
entire given date range inclusive but not confined to the date range.
In plenary mode, the returned list contains all known results or an
error results. Otherwise, the returned list may contain only those
results that are accessible through this session.
In effective mode, results are returned that are currently effective.
In any effective mode, effective results and those currently expired
are returned.resultGenusType
- a results genus typefrom
- start of date rangeto
- end of date range ResultList
InvalidArgumentException
- from
is
greater than to
NullArgumentException
- resultGenusType, from or
to
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. ResultList getResultsForParticipant(Id participantId) throws OperationFailedException, PermissionDeniedException
ResultList
for the given participant Id.
In plenary mode, the returned list contains all of the
results corresponding to the given participant, including duplicates,
or an error results if an result is inaccessible. Otherwise,
inaccessible Results
may be omitted from the list.
In effective mode, results are returned that are currently effective.
In any effective mode, effective results and those currently expired
are returned.participantId
- a participant Id
ResultList
NullArgumentException
- participantId
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. ResultList getResultsByGenusTypeForParticipant(Id participantId, Type resultGenusType) throws OperationFailedException, PermissionDeniedException
ResultList
for the given participant Id.
In plenary mode, the returned list contains all of the
results corresponding to the given participant, including duplicates,
or an error results if an result is inaccessible. Otherwise,
inaccessible Results
may be omitted from the list.
In effective mode, results are returned that are currently effective.
In any effective mode, effective results and those currently expired
are returned.participantId
- a participant Id
resultGenusType
- a results genus type ResultList
NullArgumentException
- participantId
or
resultGenusType
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. ResultList getResultsForParticipantOnDate(Id participantId, DateTime from, DateTime to) throws OperationFailedException, PermissionDeniedException
participantId
- a participant Id
from
- start of date rangeto
- end of date range ResultList
InvalidArgumentException
- from
is
greater than to
NullArgumentException
- participantId, from,
or to
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. ResultList getResultsByGenusTypeForParticipantOnDate(Id participantId, Type resultGenusType, DateTime from, DateTime to) throws OperationFailedException, PermissionDeniedException
participantId
- a participant Id
resultGenusType
- a results genus typefrom
- start of date rangeto
- end of date range ResultList
InvalidArgumentException
- from
is
greater than to
NullArgumentException
- participantId,
resultGenusType, from,
or to
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. ResultList getResults() throws OperationFailedException, PermissionDeniedException
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented.