public interface TermNotificationSession extends OsidSession
This session defines methods to receive notifications on adds/changes
to Term
objects in this CourseCatalog.
This
also includes existing terms that may appear or disappear due to changes
in the CourseCatalog
hierarchy, 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 two views defined in this session correspond to the views in the
TermLookupSession.
Modifier and Type | Method and Description |
---|---|
boolean |
canRegisterForTermNotifications()
Tests if this user can register for
Term notifications. |
CourseCatalog |
getCourseCatalog()
Gets the
CourseCatalog associated with this session. |
Id |
getCourseCatalogId()
Gets the
CourseCatalog Id associated
with this session. |
void |
registerForChangedTerm(Id termId)
Registers for notification of an updated term.
|
void |
registerForChangedTerms()
Registers for notification of updated courses.
|
void |
registerForDeletedTerm(Id termId)
Registers for notification of a deleted term.
|
void |
registerForDeletedTermAncestors(Id termId)
Registers for notification if an ancestor is removed from the
specified term in the term hierarchy.
|
void |
registerForDeletedTermDescendants(Id termId)
Registers for notification if a descendant is removed from fthe
specified term in the term hierarchy.
|
void |
registerForDeletedTerms()
Registers for notification of deleted terms.
|
void |
registerForNewTermAncestors(Id termId)
Registers for notification if an ancestor is added to the specified
term in the term hierarchy.
|
void |
registerForNewTermDescendants(Id termId)
Registers for notification if a descendant is added to the specified
term in the term hierarchy.
|
void |
registerForNewTerms()
Register for notifications of new terms.
|
void |
useFederatedCourseCatalogView()
Federates the view for methods in this session.
|
void |
useIsolatedCourseCatalogView()
Isolates the view for methods in this session.
|
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
Id getCourseCatalogId()
CourseCatalog
Id
associated
with this session. CourseCatalog Id
associated with this
sessionmandatory
- This method must be implemented. CourseCatalog getCourseCatalog() throws OperationFailedException, PermissionDeniedException
CourseCatalog
associated with this session.OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. boolean canRegisterForTermNotifications()
Term
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 useFederatedCourseCatalogView()
mandatory
- This method is must be implemented. void useIsolatedCourseCatalogView()
mandatory
- This method is must be implemented. void registerForNewTerms() throws OperationFailedException, PermissionDeniedException
TermReceiver.newTerm()
is invoked when a new Term
appears in this
course catalog.OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. void registerForNewTermAncestors(Id termId) throws OperationFailedException, PermissionDeniedException
TermReceiver.newTermAncestor()
is invoked when the specified term experiences an addition in
ancestry.termId
- the Id
of the term to monitorNullArgumentException
- termId is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. void registerForNewTermDescendants(Id termId) throws OperationFailedException, PermissionDeniedException
TermReceiver.newTermDescendant()
is invoked when the specified term experiences an addition in
descendants.termId
- the Id
of the term to monitorNullArgumentException
- termId is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. void registerForChangedTerms() throws OperationFailedException, PermissionDeniedException
TermReceiver.changedTerm()
is invoked when a term in this
course catalog is changed.OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. void registerForChangedTerm(Id termId) throws OperationFailedException, PermissionDeniedException
TermReceiver.changedTerm()
is invoked when the specified term
in this course catalog is changed.termId
- the Id
of the Term
to
monitorNullArgumentException
- termId
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. void registerForDeletedTerms() throws OperationFailedException, PermissionDeniedException
TermReceiver.deletedTerm()
is invoked when a term is deleted
or removed from this course catalog.OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. void registerForDeletedTerm(Id termId) throws OperationFailedException, PermissionDeniedException
TermReceiver.deletedTerm()
is invoked when the specified term
is deleted or removed from this course catalog.termId
- the Id
of the Term
to
monitorNullArgumentException
- termId
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. void registerForDeletedTermAncestors(Id termId) throws OperationFailedException, PermissionDeniedException
TermReceiver.deletedTermAncestor()
is invoked when the
specified term experiences a removal of an ancestor.termId
- the Id
of the term to monitorNullArgumentException
- temId is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. void registerForDeletedTermDescendants(Id termId) throws OperationFailedException, PermissionDeniedException
TermReceiver.deletedTermDescednant()
is invoked when the
specified term experiences a removal of one of its descdendents.termId
- the Id
of the term to monitorNullArgumentException
- temId is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented.