Central Repository Notification Handler API: API description

Central Repository Notification Handler API is a library and a settings API providing an easy-to-use implementation of a CActive-based wrapper for Central Repository single-shot notifications. The API is meant for all applications and servers which need to listen for changes in Central Repository keys.

The type of the API is Server-Client interface.

Use cases

• Create an instance used for listening to notifications

• Start listening for notifications

• Stop listening for notifications

• Release the instance.

API class structure

Notifications on Central Repository are set up via the CCenRepNotifyHandler class instance. The CCenRepNotifyHandler class is an active object wrapper for Central Repository one-shot notification handling. The CCenRepNotifyHandler class inherits from CActive and automatically resubscribes all notifications, as long as there is no error. The client is notified via the MCenRepNotifyHandlerCallback interface.

The MCenRepNotifyHandlerCallback class provides a callback interface for handling the notification events from Central Repository. The client derives a class from this interface and implements the HandleNotify methods that interest it. An empty default implementation is provided for all of the methods. In a debug build the default implementations print out a debug trace.

To use Central Repository Notification Handler, access to Central Repository (centralrepository.h) is needed.