Interface | osid.filing.DirectoryNotificationSession | ||
---|---|---|---|
Implements | osid.OsidSession | ||
Description |
This session defines methods to receive notifications on
adds/changes to Two view are defined in this session: federated view: includes notifications of directories located in descendants of this directory isolated view: includes notifcations of directories in this directory only | ||
Method | getDirectoryId | ||
Description |
Gets the | ||
Return | osid.id.Id | the Id of this directory | |
Compliance | mandatory | This method must be implemented. | |
Method | getDirectory | ||
Description |
Gets the | ||
Return | osid.filing.Directory | the Directory associated with this session | |
Errors | OPERATION_FAILED | unable to complete request | |
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | canRegisterForDirectoryNotifications | ||
Description |
Tests if this user can register for | ||
Return | boolean | false if notification methods are not authorized,
true otherwise | |
Compliance | mandatory | This method must be implemented. | |
Method | useFederatedDirectoryView | ||
Description |
Federates the view for methods in this session. A federated view will include directories in directories which are children of this directory. | ||
Compliance | mandatory | This method is must be implemented. | |
Method | useIsolatedDirectoryView | ||
Description |
Isolates the view for methods in this session. An isolated view restricts notifications to this diretory only. | ||
Compliance | mandatory | This method is must be implemented. | |
Method | reliableDirectoryNotifications | ||
Description |
Reliable notifications are desired. In reliable mode,
notifications are to be acknowledged using | ||
Compliance | mandatory | This method is must be implemented. | |
Method | unreliableDirectoryNotifications | ||
Description |
Unreliable notifications are desired. In unreliable mode, notifications do not need to be acknowledged. | ||
Compliance | mandatory | This method is must be implemented. | |
Method | acknowledgeDirectoryNotification | ||
Description |
Acknowledge a directory notification. | ||
Parameters | osid.id.Id | notificationId | the Id of the notification |
Errors | OPERATION_FAILED | unable to complete request | |
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | registerForNewDirectories | ||
Description |
Register for notifications of new directories. | ||
Errors | OPERATION_FAILED | unable to complete request | |
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | registerForChangedDirectories | ||
Description |
Registers for notification of updated directories.
| ||
Errors | OPERATION_FAILED | unable to complete request | |
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | registerForChangedDirectory | ||
Description |
Registers for notification of an updated file. | ||
Parameters | osid.id.Id | directoryId | the Id of the directory to monitor |
Errors | NULL_ARGUMENT | directoryId is null | |
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | registerForDeletedDirectories | ||
Description |
Registers for notification of deleted directories.
| ||
Errors | OPERATION_FAILED | unable to complete request | |
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | registerForDeletedDirectory | ||
Description |
Registers for notification of a deleted directory.
| ||
Parameters | osid.id.Id | directoryId | the Id of the directory to monitor |
Errors | NULL_ARGUMENT | directoryId is null | |
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. |