public interface DepotQuerySession extends OsidSession
This session provides methods for searching among Depot
objects. The search query is constructed using the DepotQuery.
Depots may have a query record indicated by their respective record
types. The query record is accessed via the DepotQuery.
Modifier and Type | Method and Description |
---|---|
boolean |
canSearchDepots()
Tests if this user can perform
Depot searches. |
DepotQuery |
getDepotQuery()
Gets a depot query.
|
DepotList |
getDepotsByQuery(DepotQuery depotQuery)
Gets a list of
Depot objects matching the given depot
query. |
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
boolean canSearchDepots()
Depot
searches. A return
of true does not guarantee successful authorization. A return of false
indicates that it is known all methods in this session will result in
a PERMISSION_DENIED.
This is intended as a hint to an
application that may opt not to offer search operations to
unauthorized users. false
if search methods are not authorized,
true
otherwisemandatory
- This method must be implemented. DepotQuery getDepotQuery()
mandatory
- This method must be implemented. DepotList getDepotsByQuery(DepotQuery depotQuery) throws OperationFailedException, PermissionDeniedException
Depot
objects matching the given depot
query.depotQuery
- the depot query DepotList
NullArgumentException
- depotQuery
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failureUnsupportedException
- depotQuery
is not
of this servicemandatory
- This method must be implemented.