public interface BrokerQuerySession extends OsidSession
This session provides methods for searching among Broker
objects. The search query is constructed using the BrokerQuery.
This session defines views that offer differing behaviors for searching.
Brokers may have a query record indicated by their respective record
types. The query record is accessed via the BrokerQuery.
Modifier and Type | Method and Description |
---|---|
boolean |
canSearchBrokers()
Tests if this user can perform
Broker lookups. |
BrokerQuery |
getBrokerQuery()
Gets a broker query.
|
BrokerList |
getBrokersByQuery(BrokerQuery brokerQuery)
Gets a list of
Brokers matching the given broker query. |
Distributor |
getDistributor()
Gets the
Distributor associated with this session. |
Id |
getDistributorId()
Gets the
Distributor Id associated with
this session. |
void |
useFederatedDistributorView()
Federates the view for methods in this session.
|
void |
useIsolatedDistributorView()
Isolates the view for methods in this session.
|
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
Id getDistributorId()
Distributor
Id
associated with
this session. Distributor Id
associated with this sessionmandatory
- This method must be implemented. Distributor getDistributor() throws OperationFailedException, PermissionDeniedException
Distributor
associated with this session.OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. boolean canSearchBrokers()
Broker
lookups. 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 not offer lookup operations to unauthorized
users. false
if search methods are not authorized,
true
otherwisemandatory
- This method must be implemented. void useFederatedDistributorView()
mandatory
- This method is must be implemented. void useIsolatedDistributorView()
mandatory
- This method is must be implemented. BrokerQuery getBrokerQuery()
mandatory
- This method must be implemented. BrokerList getBrokersByQuery(BrokerQuery brokerQuery) throws OperationFailedException, PermissionDeniedException
Brokers
matching the given broker query.brokerQuery
- the broker query BrokerList
NullArgumentException
- brokerQuery
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failureUnsupportedException
- brokerQuery
is
not of this servicemandatory
- This method must be implemented.