public interface OffsetEventEnablerNotificationSession extends OsidSession
This session defines methods to receive notifications on adds/changes
to OffsetEventEnabler
objects in this Calendar.
This also includes existing OffsetEventEnablers
that may appear or disappear due to changes in the Calendar
hierarchy, This session is intended for consumers needing to synchronize
their state with this service without the use of polling. Notifications
are cancelled when this session is closed.
The two views defined in this session correspond to the views in the
OffsetEventEnablerLookupSession.
Modifier and Type | Method and Description |
---|---|
void |
acknowledgeOffsetEventEnablerNotification(Id notificationId)
Acknowledge an offset event enabler notification.
|
boolean |
canRegisterForOffsetEventEnablerNotifications()
Tests if this user can register for
OffsetEventEnabler
notifications. |
Calendar |
getCalendar()
Gets the
Calendar associated with this session. |
Id |
getCalendarId()
Gets the
Calendar Id associated with
this session. |
void |
registerForChangedOffsetEventEnabler(Id offsetEventEnablerId)
Registers for notification of an updated offset event enabler.
|
void |
registerForChangedOffsetEventEnablers()
Registers for notification of updated calendar enablers.
|
void |
registerForDeletedOffsetEventEnabler(Id offsetEventEnablerId)
Registers for notification of a deleted offset event enabler.
|
void |
registerForDeletedOffsetEventEnablers()
Registers for notification of deleted offset event enablers.
|
void |
registerForNewOffsetEventEnablers()
Register for notifications of new offset event enablers.
|
void |
reliableOffsetEventEnablerNotifications()
Reliable notifications are desired.
|
void |
unreliableOffsetEventEnablerNotifications()
Unreliable notifications are desired.
|
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.OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. boolean canRegisterForOffsetEventEnablerNotifications()
OffsetEventEnabler
notifications. 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 notification operations. false
if notification 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. void reliableOffsetEventEnablerNotifications()
acknowledgeOffsetEventEnablerNotification()
.mandatory
- This method is must be implemented. void unreliableOffsetEventEnablerNotifications()
mandatory
- This method is must be implemented. void acknowledgeOffsetEventEnablerNotification(Id notificationId) throws OperationFailedException, PermissionDeniedException
notificationId
- the Id
of the notificationOperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. void registerForNewOffsetEventEnablers() throws OperationFailedException, PermissionDeniedException
OffsetEventEnablerReceiver.newOffsetEventEnablers()
is invoked
when a new OffsetEventEnabler
appears in this calendar.OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. void registerForChangedOffsetEventEnablers() throws OperationFailedException, PermissionDeniedException
OffsetEventEnablerReceiver.changedOffsetEventEnablers()
is
invoked when an offset event enabler in this calendar is changed.OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. void registerForChangedOffsetEventEnabler(Id offsetEventEnablerId) throws OperationFailedException, PermissionDeniedException
OffsetEventEnablerReceiver.changedOffsetEventEnablers()
is
invoked when the specified offset event enabler in this calendar is
changed.offsetEventEnablerId
- the Id
of the
OffsetEventEnabler
to monitorNullArgumentException
- offsetEventEnablerId
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. void registerForDeletedOffsetEventEnablers() throws OperationFailedException, PermissionDeniedException
OffsetEventEnablerReceiver.deletedOffsetEventEnablers()
is
invoked when an offset event enabler is deleted or removed from this
calendar.OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. void registerForDeletedOffsetEventEnabler(Id offsetEventEnablerId) throws OperationFailedException, PermissionDeniedException
OffsetEventEnablerReceiver.deletedOffsetEventEnablers()
is
invoked when the specified offset event enabler is deleted or removed
from this calendar.offsetEventEnablerId
- the Id
of the
OffsetEventEnabler
to monitorNullArgumentException
- offsetEventEnablerId
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented.