public interface StoreQuerySession extends OsidSession
This session provides methods for searching Store
objects. The search query is constructed using the StoreQuery.
The store record Type
also specifies the record for
the store query.
Stores may have a query record indicated by their respective record
types. The query record is accessed via the StoreQuery.
The
returns in this session may not be cast directly to these interfaces.
Modifier and Type | Method and Description |
---|---|
boolean |
canSearchStores()
Tests if this user can perform
Store searches. |
StoreQuery |
getStoreQuery()
Gets a store query.
|
StoreList |
getStoresByQuery(StoreQuery storeQuery)
Gets a list of
Stores matching the given store query. |
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
boolean canSearchStores()
Store
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. StoreQuery getStoreQuery()
mandatory
- This method must be implemented. StoreList getStoresByQuery(StoreQuery storeQuery) throws OperationFailedException, PermissionDeniedException
Stores
matching the given store query.storeQuery
- the store query StoreList
NullArgumentException
- storeQuery
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failureUnsupportedException
- storeQuery
is not
of this servicemandatory
- This method must be implemented.