public interface SceneNotificationSession extends OsidSession
This session defines methods to receive notifications on adds/changes
to Scene
objects in this dDstributor.
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
SceneLookupSession.
Modifier and Type | Method and Description |
---|---|
void |
acknowledgeSceneNotification(Id notificationId)
Acknowledge a scene notification.
|
boolean |
canRegisterForSceneNotifications()
Tests if this user can register for
Scene
notifications. |
System |
getSystem()
Gets the
System associated with this session. |
Id |
getSystemId()
Gets the
System Id associated with this
session. |
void |
registerForChangedScene(Id sceneId)
Registers for notification of an updated scene.
|
void |
registerForChangedScenes()
Registers for notification of updated scenes.
|
void |
registerForDeletedScene(Id sceneId)
Registers for notification of a deleted scene.
|
void |
registerForDeletedScenes()
Registers for notification of deleted scenes.
|
void |
registerForNewScenes()
Register for notifications of new scenes.
|
void |
reliableSceneNotifications()
Reliable notifications are desired.
|
void |
unreliableSceneNotifications()
Unreliable notifications are desired.
|
void |
useFederatedSystemView()
Federates the view for methods in this session.
|
void |
useIsolatedSystemView()
Isolates the view for methods in this session.
|
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
Id getSystemId()
System
Id
associated with this
session. System Id
associated with this sessionmandatory
- This method must be implemented. System getSystem() throws OperationFailedException, PermissionDeniedException
System
associated with this session.OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. boolean canRegisterForSceneNotifications()
Scene
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 useFederatedSystemView()
mandatory
- This method is must be implemented. void useIsolatedSystemView()
mandatory
- This method is must be implemented. void reliableSceneNotifications()
acknowledgeSceneNotification()
.mandatory
- This method is must be implemented. void unreliableSceneNotifications()
mandatory
- This method is must be implemented. void acknowledgeSceneNotification(Id notificationId) throws OperationFailedException, PermissionDeniedException
notificationId
- the Id
of the notificationOperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. void registerForNewScenes() throws OperationFailedException, PermissionDeniedException
SceneReceiver.newScenes()
is invoked when a new Scene
appears in this system.OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. void registerForChangedScenes() throws OperationFailedException, PermissionDeniedException
SceneReceiver.changedScenes()
is invoked when a scene in this
system is changed.OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. void registerForChangedScene(Id sceneId) throws OperationFailedException, PermissionDeniedException
SceneReceiver.changedScenes()
is invoked when the specified
scene in this system is changed.sceneId
- the Id
of the Scene
to
monitorNullArgumentException
- sceneId
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. void registerForDeletedScenes() throws OperationFailedException, PermissionDeniedException
SceneReceiver.deletedScenes()
is invoked when a scene is
deleted or removed from this system.OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. void registerForDeletedScene(Id sceneId) throws OperationFailedException, PermissionDeniedException
SceneReceiver.deletedScenes()
is invoked when the specified
scene is deleted or removed from this system.sceneId
- the Id
of the Scene
to
monitorNullArgumentException
- sceneId
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented.