public interface TimePeriodQuerySession extends OsidSession
This session provides methods for searching TimePeriod
objects. The search query is constructed using the TimePeriodQuery.
The time period record Type
also specifies the
record for the time period query.
Time periods may have a query record indicated by their respective
record types. The query record is accessed via the TimePeriodQuery.
Modifier and Type | Method and Description |
---|---|
boolean |
canSearchTimePeriods()
Tests if this user can perform
TimePeriod searches. |
Calendar |
getCalendar()
Gets the
Calendar associated with this session. |
Id |
getCalendarId()
Gets the
Calendar Id associated with
this session. |
TimePeriodQuery |
getTimePeriodQuery()
Gets a time period query.
|
TimePeriodList |
getTimePeriodsByQuery(TimePeriodQuery timePeriodQuery)
Gets a list of
TimePeriods matching the given query. |
void |
useFederatedCalendarView()
Federates the view for methods in this session.
|
void |
useIsolatedCalendarView()
Isolates the view for methods in this session.
|
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
Id getCalendarId()
Calendar
Id
associated with
this session. Calendar Id
associated with this sessionmandatory
- This method must be implemented. Calendar getCalendar() throws OperationFailedException, PermissionDeniedException
Calendar
associated with this session. Calendar
associated with this sessionOperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. boolean canSearchTimePeriods()
TimePeriod
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 useFederatedCalendarView()
mandatory
- This method is must be implemented. void useIsolatedCalendarView()
mandatory
- This method is must be implemented. TimePeriodQuery getTimePeriodQuery()
mandatory
- This method must be implemented. TimePeriodList getTimePeriodsByQuery(TimePeriodQuery timePeriodQuery) throws OperationFailedException, PermissionDeniedException
TimePeriods
matching the given query.timePeriodQuery
- the time period query TimePeriodList
NullArgumentException
- timePeriodQuery
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failureUnsupportedException
- timePeriodQuery
is not of this servicemandatory
- This method must be implemented.