OSID Logo
OSID Specifications
ontology package
Version 3.0.0
Release Candidate Preview
Interfaceosid.ontology.RelevancyNotificationSession
Implementsosid.OsidSession
Description

This session defines methods to receive asynchronous notifications on adds/changes to subject relevancies. 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 views defined in this session correspond to the views in the RelevancyLookupSession.

MethodgetOntologyId
Description

Gets the Ontology Id associated with this session.

Returnosid.id.Idthe Ontology Id associated with this session
CompliancemandatoryThis method must be implemented.
MethodgetOntology
Description

Gets the Ontology associated with this session.

Returnosid.ontology.Ontologythe Ontology associated with this session
ErrorsOPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodcanRegisterForRelevancyNotifications
Description

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

Federates the view for methods in this session. A federated view will include notifications for relevancies in ontologies which are children of this ontology in the ontology hierarchy.

CompliancemandatoryThis method is must be implemented.
MethoduseIsolatedOntologyView
Description

Isolates the view for methods in this session. An isolated view restricts notifications to this ontology only.

CompliancemandatoryThis method is must be implemented.
MethodreliableRelevancyNotifications
Description

Reliable notifications are desired. In reliable mode, notifications are to be acknowledged using acknowledgeRelevancyNotification() .

CompliancemandatoryThis method is must be implemented.
MethodunreliableRelevancyNotifications
Description

Unreliable notifications are desired. In unreliable mode, notifications do not need to be acknowledged.

CompliancemandatoryThis method is must be implemented.
MethodacknowledgeRelevancyNotification
Description

Acknowledge a relevancy notification.

Parametersosid.id.IdnotificationIdthe Id of the notification
ErrorsOPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodregisterForNewRelevancies
Description

Register for notifications of new relevancies. RelevancyReceiver.newRelevancies() is invoked when a new relevancy is created.

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

Register for notifications of new relevancies by the given genus type. RelevancyReceiver.newRelevancies() is invoked when a new relevancy is created.

Parametersosid.type.TyperelevancyGenusTypethe relevancy genus type
ErrorsNULL_ARGUMENT relevancyGenusType is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodregisterForNewRelevanciesForSubject
Description

Register for notifications of new relevancies for the given subject. RelevancyReceiver.newRelevancies() is invoked when a new relevancy is created.

Parametersosid.id.IdsubjectIdthe Id of the Subject to monitor
ErrorsNULL_ARGUMENT subjectId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodregisterForNewRelevanciesForId
Description

Register for notifications of new relevancies for the given mapped Id. RelevancyReceiver.newRelevancies() is invoked when a new relevancy is created.

Parametersosid.id.Ididthe Id to monitor
ErrorsNULL_ARGUMENT id is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodregisterForChangedRelevancies
Description

Registers for notification of updated relevancies. RelevancyReceiver.changedRelevancies() is invoked when a relevancy is changed.

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

Register for notifications of changed relevancies of the given genus type. RelevancyReceiver.changedRelevancies() is invoked when a relevancy is changed.

Parametersosid.type.TyperelevancyGenusTypethe relevancy genus type
ErrorsNULL_ARGUMENT relevancyGenusType is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodregisterForChangedRelevanciesForSubject
Description

Register for notifications of changed relevancies for the given subject. RelevancyReceiver.changedRelevancies() is invoked when a relevancy is changed.

Parametersosid.id.IdsubjectIdthe Id of the Subject to monitor
ErrorsNULL_ARGUMENT subjectId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodregisterForChangedRelevanciesForId
Description

Register for notifications of changed relevancies for the given Id. RelevancyReceiver.changedRelevancies() is invoked when a relevancy is changed.

Parametersosid.id.Ididthe Id to monitor
ErrorsNULL_ARGUMENT id is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodregisterForChangedRelevancy
Description

Registers for notification of an updated relevancy. RelevancyReceiver.changedRelevancies() is invoked when the specified relevancy is changed.

Parametersosid.id.IdrelevancyIdthe Id of the Relevancy to monitor
ErrorsNULL_ARGUMENT relevancyId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodregisterForDeletedRelevancies
Description

Registers for notification of deleted relevancies. RelevancyReceiver.deletedRelevancies() is invoked when a relevancy is deleted.

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

Register for notifications of deleted relevancies of the given genus type. RelevancyReceiver.deletedRelevancies() is invoked when a relevancy is deleted.

Parametersosid.type.TyperelevancyGenusTypethe relevancy genus type
ErrorsNULL_ARGUMENT relevancyGenusType is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodregisterForDeletedRelevanciesForSubject
Description

Register for notifications of deleted relevancies for the given subject. RelevancyReceiver.deletedRelevancies() is invoked when a relevancy is deleted.

Parametersosid.id.IdsubjectIdthe Id of the Subject to monitor
ErrorsNULL_ARGUMENT subjectId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodregisterForDeletedRelevanciesForId
Description

Register for notifications of deleted relevancies for the given Id. RelevancyReceiver.deletedRelevancies() is invoked when a relevancy is deleted.

Parametersosid.id.Ididthe Id to monitor
ErrorsNULL_ARGUMENT id is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodregisterForDeletedRelevancy
Description

Registers for notification of a deleted relevancy. RelevancyReceiver.changedRelevancies() is invoked when the specified relevancy is deleted.

Parametersosid.id.IdrelevancyIdthe Id of the Relevancy to monitor
ErrorsNULL_ARGUMENT relevancyId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.