OSID Logo
OSID Specifications
resource package
Version 3.0.0
Release Candidate Preview
Interfaceosid.resource.BinNotificationSession
Implementsosid.OsidSession
Description

This session defines methods to receive notifications on adds/changes to Bin 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.

MethodcanRegisterForBinNotifications
Description

Tests if this user can register for Bin 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.

Returnboolean false if notification methods are not authorized, true otherwise
CompliancemandatoryThis method must be implemented.
MethodregisterForNewBins
Description

Register for notifications of new bins. BinReceiver.newBins() is invoked when a new Bin is created.

ErrorsOPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodregisterForNewBinAncestors
Description

Registers for notification if an ancestor is added to the specified bin in the bin hierarchy. BinReceiver.newBinAncestor() is invoked when the specified bin experiences an addition in ancestry.

Parametersosid.id.IdbinIdthe Id of the bin to monitor
ErrorsNULL_ARGUMENT binId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodregisterForNewBinDescendants
Description

Registers for notification if a descendant is added to the specified bin in the bin hierarchy. BinReceiver.newBinDescendant() is invoked when the specified bin experiences an addition in descendants.

Parametersosid.id.IdbinIdthe Id of the bin to monitor
ErrorsNULL_ARGUMENT binId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodregisterForChangedBins
Description

Registers for notification of updated bins. BinReceiver.changedBins() is invoked when a bin is changed.

ErrorsOPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodregisterForChangedBin
Description

Registers for notification of an updated bin. BinReceiver.changedBins() is invoked when the specified bin is changed.

Parametersosid.id.IdbinIdthe Id of the Bin to monitor
ErrorsNULL_ARGUMENT binId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodregisterForDeletedBins
Description

Registers for notification of deleted bins. BinReceiver.deletedBins() is invoked when a bin is deleted.

ErrorsOPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodregisterForDeletedBin
Description

Registers for notification of a deleted bin. BinReceiver.deletedBins() is invoked when the specified bin is deleted.

Parametersosid.id.IdbinIdthe Id of the Bin to monitor
ErrorsNULL_ARGUMENT binId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodregisterForDeletedBinAncestors
Description

Registers for notification if an ancestor is removed from the specified bin in the bin hierarchy. BinReceiver.deletedBinAncestor() is invoked when the specified bin experiences a removal of an ancestor.

Parametersosid.id.IdbinIdthe Id of the bin to monitor
ErrorsNULL_ARGUMENT binId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodregisterForDeletedBinDescendants
Description

Registers for notification if a descendant is removed from fthe specified bin in the bin hierarchy. BinReceiver.deletedBinDescendnant() is invoked when the specified bin experiences a removal of one of its descdendents.

Parametersosid.id.IdbinIdthe Id of the bin to monitor
ErrorsNULL_ARGUMENT binId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.