public interface StatisticQuerySession extends OsidSession
This session provides methods for searching statistics. The search
query is constructed using the StatisticQuery.
This session defines views that offer differing behaviors for searching.
Modifier and Type | Method and Description |
---|---|
boolean |
canSearchStatistics()
Tests if this user can perform
Statistic searches. |
StatisticQuery |
getStatisticQuery()
Gets a statistic query.
|
StatisticList |
getStatisticsByQuery(StatisticQuery statisticQuery)
Gets a list of statistics matching the given statistics query.
|
Utility |
getUtility()
Gets the
Utility associated with this session. |
Id |
getUtilityId()
Gets the
Utility Id associated with this
session. |
void |
useFederatedUtilityView()
Federates the view for methods in this session.
|
void |
useIsolatedUtilityView()
Isolates the view for methods in this session.
|
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
Id getUtilityId()
Utility
Id
associated with this
session. Utility Id
associated with this sessionmandatory
- This method must be implemented. Utility getUtility() throws OperationFailedException, PermissionDeniedException
Utility
associated with this session. Utility
associated with this sessionOperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. boolean canSearchStatistics()
Statistic
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. void useFederatedUtilityView()
mandatory
- This method is must be implemented. void useIsolatedUtilityView()
mandatory
- This method is must be implemented. StatisticQuery getStatisticQuery()
mandatory
- This method must be implemented. StatisticList getStatisticsByQuery(StatisticQuery statisticQuery) throws OperationFailedException, PermissionDeniedException
statisticQuery
- the statistics query StatisticList
NullArgumentException
- statisticQuery
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failureUnsupportedException
- statisticQuery
is
not of this servicemandatory
- This method must be implemented.