public interface EventSmartCalendarSession extends OsidSession
This session manages queries and sequencing to create "smart" dynamic
catalogs. An EventQuery
can be retrieved from this session
and mapped to this Calendar
to create a virtual collection
of Events.
The entries may be sequenced using the
EventSearchOrder
from this session.
This Calendar
has a default query that matches any
event and a default search order that specifies no sequencing. The queries
may be examined using an EventQueryInspector.
The query may
be modified by converting the inspector back to an EventQuery.
Modifier and Type | Method and Description |
---|---|
void |
applyEventQuery(EventQuery eventQuery)
Applies an event query to this calendar.
|
void |
applyEventSequencing(EventSearchOrder eventSearchOrder)
Applies an event search order to this calendar.
|
boolean |
canManageSmartCalendars()
Tests if this user can manage smart calendars.
|
Calendar |
getCalendar()
Gets the
Calendar associated with this session. |
Id |
getCalendarId()
Gets the
Calendar Id associated with
this session. |
EventQuery |
getEventQuery()
Gets an event query.
|
EventQuery |
getEventQueryFromInspector(EventQueryInspector eventQueryInspector)
Gets an event query from an inspector.
|
EventSearchOrder |
getEventSearchOrder()
Gets an event search order.
|
EventQueryInspector |
inspectEventQuery()
Gets an event query inspector for this calendar.
|
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 canManageSmartCalendars()
PERMISSION_DENIED.
This is intended as a hint to an
application that may opt not to offer smart operations. false
if smart calendar methods are not
authorized, true
otherwisemandatory
- This method must be implemented. EventQuery getEventQuery()
mandatory
- This method must be implemented. EventSearchOrder getEventSearchOrder()
mandatory
- This method must be implemented. void applyEventQuery(EventQuery eventQuery) throws OperationFailedException, PermissionDeniedException
eventQuery
- the event queryNullArgumentException
- eventQuery
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failure
occurredUnsupportedException
- eventQuery
not of
this servicemandatory
- This method must be implemented. EventQueryInspector inspectEventQuery() throws OperationFailedException, PermissionDeniedException
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failure
occurredmandatory
- This method must be implemented. void applyEventSequencing(EventSearchOrder eventSearchOrder) throws OperationFailedException, PermissionDeniedException
eventSearchOrder
- the event search orderNullArgumentException
- eventSearchOrder
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failure
occurredUnsupportedException
- eventSearchOrder
not of this servicemandatory
- This method must be implemented. EventQuery getEventQueryFromInspector(EventQueryInspector eventQueryInspector)
eventQueryInspector
- an event query inspectorNullArgumentException
- eventQueryInspector
is null
UnsupportedException
- eventQueryInspector
is not of this servicemandatory
- This method must be implemented.