public interface ItemQuerySession extends OsidSession
This session provides methods for searching Item
objects. The search query is constructed using the ItemQuery.
The assessment item record Type
also specifies the
query record for the assessment item query.
This session defines views that offer differing behaviors for searching.
Assessment items may have a query record indicated by their respective
record types. Thequery record is accessed via the ItemQuery.
Modifier and Type | Method and Description |
---|---|
boolean |
canSearchItems()
Tests if this user can perform
Item searches. |
Bank |
getBank()
Gets the
Bank associated with this session. |
Id |
getBankId()
Gets the
Bank Id associated with this
session. |
ItemQuery |
getItemQuery()
Gets an assessment item query.
|
ItemList |
getItemsByQuery(ItemQuery itemQuery)
Gets a list of
Items matching the given item query. |
void |
useFederatedBankView()
Federates the view for methods in this session.
|
void |
useIsolatedBankView()
Isolates the view for methods in this session.
|
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
Id getBankId()
Bank
Id
associated with this
session. Bank Id
associated with this sessionmandatory
- This method must be implemented. Bank getBank() throws OperationFailedException, PermissionDeniedException
Bank
associated with this session. Bank
associated with this sessionOperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. boolean canSearchItems()
Item
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
pplication that may wish not to offer search operations to
unauthorized users. false
if search methods are not authorized,
true
otherwisemandatory
- This method must be implemented. void useFederatedBankView()
mandatory
- This method is must be implemented. void useIsolatedBankView()
mandatory
- This method is must be implemented. ItemQuery getItemQuery()
mandatory
- This method must be implemented. ItemList getItemsByQuery(ItemQuery itemQuery) throws OperationFailedException, PermissionDeniedException
Items
matching the given item query.itemQuery
- the item query ItemList
NullArgumentException
- itemQuery
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failure
occurredUnsupportedException
- itemQuery
is not
of this servicemandatory
- This method must be implemented.