public interface BuildingNotificationSession extends OsidSession
This session defines methods to receive notifications on adds/changes
to Building
objects. 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.
Notifications are triggered with changes to the Building
object itself. Adding and removing rooms result in notifications
available from the notification session for rooms.
Modifier and Type | Method and Description |
---|---|
boolean |
canRegisterForBuildingNotifications()
Tests if this user can register for
Building
notifications. |
Campus |
getCampus()
Gets the
Campus associated with this session. |
Id |
getCampusId()
Gets the
Campus Id associated with this
session. |
void |
registerForChangedBuilding(Id buildingId)
Registers for notification of an updated building.
|
void |
registerForChangedBuildings()
Registers for notification of updated buildings.
|
void |
registerForDeletedBuilding(Id buildingId)
Registers for notification of a deleted building.
|
void |
registerForDeletedBuildings()
Registers for notification of deleted buildings.
|
void |
registerForNewBuildings()
Register for notifications of new buildings.
|
void |
useFederatedCampusView()
Federates the view for methods in this session.
|
void |
useIsolatedCampusView()
Isolates the view for methods in this session.
|
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
Id getCampusId()
Campus
Id
associated with this
session. Campus Id
associated with this sessionmandatory
- This method must be implemented. Campus getCampus() throws OperationFailedException, PermissionDeniedException
Campus
associated with this session.OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. boolean canRegisterForBuildingNotifications()
Building
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 useFederatedCampusView()
mandatory
- This method is must be implemented. void useIsolatedCampusView()
mandatory
- This method is must be implemented. void registerForNewBuildings() throws OperationFailedException, PermissionDeniedException
BuildingReceiver.newBuildings()
is invoked when a new
Building
is created.OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. void registerForChangedBuildings() throws OperationFailedException, PermissionDeniedException
BuildingReceiver.changedBuildings()
is invoked when a building
is changed.OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. void registerForChangedBuilding(Id buildingId) throws OperationFailedException, PermissionDeniedException
BuildingReceiver.changedBuildings()
is invoked when the
specified building is changed.buildingId
- the Id
of the Building
to monitorNullArgumentException
- buildingId
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. void registerForDeletedBuildings() throws OperationFailedException, PermissionDeniedException
BuildingReceiver.deletedBuildings()
is invoked when a building
is deleted.OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. void registerForDeletedBuilding(Id buildingId) throws OperationFailedException, PermissionDeniedException
BuildingReceiver.deletedBuildings()
is invoked when the
specified building is deleted.buildingId
- the Id
of the Building
to monitorNullArgumentException
- buildingId
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented.