public interface CatalogEntryNotificationSession extends OsidSession
This session defines methods to receive notifications on adds/changes to a catalog assignment. 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 assignments of Ids
to this catalog. For notifications of changes to the
Catalog
object use CatalogNotificationSession.
Modifier and Type | Method and Description |
---|---|
boolean |
canRegisterForCatalogEntryNotifications()
Tests if this user can register for
Catalog entry
notifications. |
void |
registerForDeletedCatalogEntries(Id catalogId)
Registers for notification of deleted catalogs entries.
|
void |
registerForNewCatalogEntries(Id catalogId)
Register for notifications of new catalogs.
|
void |
useFederatedCatalogView()
Federates the view for methods in this session.
|
void |
useIsolatedCatalogView()
Isolates the view for methods in this session.
|
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
boolean canRegisterForCatalogEntryNotifications()
Catalog
entry
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 useFederatedCatalogView()
mandatory
- This method is must be implemented. void useIsolatedCatalogView()
mandatory
- This method is must be implemented. void registerForNewCatalogEntries(Id catalogId) throws OperationFailedException, PermissionDeniedException
CatalogEntryReceiver.newCatalogEntry()
is invoked when a new
Catalog
entry is created.catalogId
- the Id
of the C atalog
node to monitorNullArgumentException
- catalogId
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. void registerForDeletedCatalogEntries(Id catalogId) throws OperationFailedException, PermissionDeniedException
CatalogEntryReceiver.deletedCatalogEntry()
is invoked when a
catalog entry is removed from this catalog.catalogId
- the Id
of the C atalog
node to monitorNullArgumentException
- catalogId
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented.