public interface ResourceLocationNotificationSession extends OsidSession
This session defines methods to receive notifications on adds/changes
to resources locations in this Map.
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.
Modifier and Type | Method and Description |
---|---|
void |
acknowledgeResourceLocationNotification(Id notificationId)
Acknowledge a resource location notification.
|
boolean |
canRegisterForResourceLocationNotifications()
Tests if this user can register for notifications.
|
Map |
getMap()
Gets the
Map associated with this session. |
Id |
getMapId()
Gets the
Map Id associated with this
session. |
void |
registerForEnteredLocation(Id locationId)
Register for notifications of an entered location.
|
void |
registerForEnteredLocations()
Register for notifications of entered locations for a resource.
|
void |
registerForEnteredLocationsForResource(Id resourceId)
Register for notifications of entered locations.
|
void |
registerForEnteredLocationsForResourcesByGenusType(Type resourceGenusType)
Register for notifications of entered locations for the given resource
genus type.
|
void |
registerForExitedLocation(Id locationId)
Register for notifications of an exited location.
|
void |
registerForExitedLocations()
Register for notifications of exited locations for a resource.
|
void |
registerForExitedLocationsForResource(Id resourceId)
Register for notifications of exited locations.
|
void |
registerForExitedLocationsForResourcesByGenusType(Type resourceGenusType)
Register for notifications of exited locations for the given resource
genus type.
|
void |
reliableResourceLocationNotifications()
Reliable notifications are desired.
|
void |
unreliableResourceLocationNotifications()
Unreliable notifications are desired.
|
void |
useFederatedMapView()
Federates the view for methods in this session.
|
void |
useIsolatedMapView()
Isolates the view for methods in this session.
|
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
Id getMapId()
Map
Id
associated with this
session. Map Id
associated with this sessionmandatory
- This method must be implemented. Map getMap() throws OperationFailedException, PermissionDeniedException
Map
associated with this session.OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. boolean canRegisterForResourceLocationNotifications()
PERMISSION_DENIED.
This is intended as a hint to an
application that may wish not to offer notification operations to
unauthorized users. false
if notification methods are not
authorized, true
otherwisemandatory
- This method must be implemented. void useFederatedMapView()
mandatory
- This method is must be implemented. void useIsolatedMapView()
mandatory
- This method is must be implemented. void reliableResourceLocationNotifications()
acknowledgeResourceLocationNotification()
.mandatory
- This method is must be implemented. void unreliableResourceLocationNotifications()
mandatory
- This method is must be implemented. void acknowledgeResourceLocationNotification(Id notificationId) throws OperationFailedException, PermissionDeniedException
notificationId
- the Id
of the notificationOperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. void registerForEnteredLocations() throws OperationFailedException, PermissionDeniedException
ResourceLocationReceiver.enteredLocation()
is invoked when a
resource appears in a new location.OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. void registerForEnteredLocation(Id locationId) throws OperationFailedException, PermissionDeniedException
ResourceLocationReceiver.enteredLocation()
is invoked when a
resource appears in the specified location.locationId
- the Id
of the Location
to monitorNullArgumentException
- locationId
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. void registerForEnteredLocationsForResource(Id resourceId) throws OperationFailedException, PermissionDeniedException
ResourceLocationReceiver.enteredLocation()
is invoked when the
specified resource appears in a new location.resourceId
- the Id
of the Resource
to monitorNullArgumentException
- resourceId
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. void registerForEnteredLocationsForResourcesByGenusType(Type resourceGenusType) throws OperationFailedException, PermissionDeniedException
ResourceLocationReceiver.enteredLocation()
is invoked when a resource appears in a new location.resourceGenusType
- the genus type of the Resource
to monitorNullArgumentException
- resourceGenusType
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. void registerForExitedLocations() throws OperationFailedException, PermissionDeniedException
ResourceLocationReceiver.exitedLocation()
is invoked when a
resource exits a location.OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. void registerForExitedLocation(Id locationId) throws OperationFailedException, PermissionDeniedException
ResourceLocationReceiver.exitedLocation()
is invoked when a
resource exits the specified location.locationId
- the Id
of the Location
to monitorNullArgumentException
- locationId
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. void registerForExitedLocationsForResource(Id resourceId) throws OperationFailedException, PermissionDeniedException
ResourceLocationReceiver.exitedLocation()
is invoked when the
specified resource exits a location.resourceId
- the Id
of the Resource
to monitorNullArgumentException
- resourceId
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. void registerForExitedLocationsForResourcesByGenusType(Type resourceGenusType) throws OperationFailedException, PermissionDeniedException
ResourceLocationReceiver.exitedLocation()
is invoked when a resource exits a location.resourceGenusType
- the genus type of the Resource
to monitorNullArgumentException
- resourceGenusType
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented.