public interface SupersedingEventQuerySession extends OsidSession
This session provides methods for searching SupersedingEvent
objects. The search query is constructed using the
SupersedingEventQuery.
The superseding event record Type
also specifies the record for the superseding event query.
This session defines views that offer differing behaviors for searching.
SupersedingEvents
may have a query record indicated by
their respective record types. The query record is accessed via the
SupersedingE ventQuery.
Modifier and Type | Method and Description |
---|---|
boolean |
canSearchSupersedingEvents()
Tests if this user can perform
SupersedingEvents
searches. |
Calendar |
getCalendar()
Gets the
Calendar associated with this session. |
Id |
getCalendarId()
Gets the
Calendar Id associated with
this session. |
SupersedingEventQuery |
getSupersedingEventQuery()
Gets a superseding event query.
|
SupersedingEventList |
getSupersedingEventsByQuery(SupersedingEventQuery supersedingEventQuery)
Gets a list of
SupersedingEvents matching the given
superseding event 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 canSearchSupersedingEvents()
SupersedingEvents
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. SupersedingEventQuery getSupersedingEventQuery()
mandatory
- This method must be implemented. SupersedingEventList getSupersedingEventsByQuery(SupersedingEventQuery supersedingEventQuery) throws OperationFailedException, PermissionDeniedException
SupersedingEvents
matching the given
superseding event query.supersedingEventQuery
- the superseding event query SupersedingEventList
NullArgumentException
- supersedingEventQuery
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failureUnsupportedException
- supersedingEventQuery
is not of this servicemandatory
- This method must be implemented.