CCenRepNotifyHandler Class Reference

API published in: S60 3rd Ed FP 1

Link against: cenrepnotifhandler.lib

Capability Information

Required Capabilities

None

Exceptions

Capability required depends on platform security of the repository.

#include <cenrepnotifyhandler.h>

Detailed Description

Active object wrapper for Central Repository one-shot notification handling.

Central Repository Notification Handler API provides an easy-to-use implementation of a CActive-based wrapper for Central Repository single-shot notifications. In most cases Central Repository Notification Handler can automatically resubscribe to notifications and fetch the modified value from Central Repository. The API consists of the classes CCenRepNotifyHandler and MCenRepNotifyHandlerCallback. The user of this class needs to implement relevant MCenRepNotifyHandlerCallback interface methods to receive notifications. The user of Central Repository Notification Handler API needs access to Central Repository (centralrepository.h).

Usage:

Initialization example (from a class that implements MCenRepNotifyHandlerCallback interface):

 iSession = CRepository::NewL(KTestUid);
 iNotifyHandler = CCenRepNotifyHandler::NewL(*this, *iSession, CCenRepNotifyHandler::EStringKey, KKey1);
 iNotifyHandler->StartListeningL();

Uninitialization example:

 iNotifyHandler->StopListening(); 
 delete iNotifyHandler;

Handler method implementation example:

 void CMyCenRepNotifyTest::HandleNotifyString(TUint32 aId, const TDesC16&  aNewValue)
    {
    // Print out the notified value
    RDebug::Print(_L("Key %d changed, new value: %S"), aId, &aNewValue);
    }


Public Types
enum	TCenRepKeyType { EIntKey, ERealKey, EStringKey, EBinaryKey }
	Defines different key types. More...
Public Member Functions
IMPORT_C void	StartListeningL ()
	When this method is called, the CCenRepNotifyHandler starts listening for notifications.
IMPORT_C void	StopListening ()
	When this method is called, the CCenRepNotifyHandler stops listening for notifications.
virtual IMPORT_C	~CCenRepNotifyHandler ()
	Destructor.
Static Public Member Functions
static IMPORT_C CCenRepNotifyHandler *	NewL (MCenRepNotifyHandlerCallback &aCallback, CRepository &aSession, TCenRepKeyType aKeyType, TUint32 aId)
	This is a two-phase constructor method that is used to create a new instance for listening to the changes in a single key.
static IMPORT_C CCenRepNotifyHandler *	NewL (MCenRepNotifyHandlerCallback &aCallback, CRepository &aSession)
	This is a two-phase constructor method that is used to create a new instance for listening to the changes in all keys in the repository.
static IMPORT_C CCenRepNotifyHandler *	NewLC (MCenRepNotifyHandlerCallback &aCallback, CRepository &aSession, TCenRepKeyType aKeyType, TUint32 aId)
	This is a two-phase constructor method that is used to create a new instance for listening to the changes in a single key.
static IMPORT_C CCenRepNotifyHandler *	NewLC (MCenRepNotifyHandlerCallback &aCallback, CRepository &aSession)
	This is a two-phase constructor method that is used to create a new instance for listening to the changes in all keys in the repository.
Protected Member Functions
void	RunL ()
	Implements CActive.
TInt	RunError (TInt aError)
	Implements CActive.
void	DoCancel ()
	Implements CActive.

Member Enumeration Documentation

enum CCenRepNotifyHandler::TCenRepKeyType

Defines different key types.

Enumeration is used to indicate the key type that is listened to.

Enumerator:

EIntKey	Key holds a TInt value.
ERealKey	Key holds a TReal value.
EStringKey	Key holds a TDesC16 value.
EBinaryKey	Key holds a TDesC8 value.

Constructor & Destructor Documentation

virtual IMPORT_C CCenRepNotifyHandler::~CCenRepNotifyHandler ( ) [virtual]

Destructor.

Member Function Documentation

void CCenRepNotifyHandler::DoCancel ( ) [protected]

Implements CActive.

Parameters:

none

Returns:: none

static IMPORT_C CCenRepNotifyHandler* CCenRepNotifyHandler::NewL	(	MCenRepNotifyHandlerCallback &	aCallback,
		CRepository &	aSession
	)	`[static]`

This is a two-phase constructor method that is used to create a new instance for listening to the changes in all keys in the repository.

Type specific callback methods of MCenRepNotifyHandlerCallback will not be used when notifying about changes in this case, only HandleNotifyGeneric() is used.

Parameters:

	aCallback	Reference to a callback instance.
	aSession	Reference to an existing repository session. Do not close this session until all CCenRepNotifyHandler instances referring to it have been deleted.

Returns:: A pointer to a new instance of the CCenRepNotifyHandler class.

static IMPORT_C CCenRepNotifyHandler* CCenRepNotifyHandler::NewL	(	MCenRepNotifyHandlerCallback &	aCallback,
		CRepository &	aSession,
		TCenRepKeyType	aKeyType,
		TUint32	aId
	)	`[static]`

This is a two-phase constructor method that is used to create a new instance for listening to the changes in a single key.

Parameters:

	aCallback	Reference to a callback instance.
	aSession	Reference to an existing repository session. Do not close this session until all CCenRepNotifyHandler instances referring to it have been deleted.
	aKeyType	Type of the key identified by aId parameter.
	aId	Id of the key that change notifications are needed for.

Returns:: A pointer to a new instance of the CCenRepNotifyHandler class.

Leave:: KErrArgument if invalid key type is passed as a parameter.

static IMPORT_C CCenRepNotifyHandler* CCenRepNotifyHandler::NewLC	(	MCenRepNotifyHandlerCallback &	aCallback,
		CRepository &	aSession
	)	`[static]`

This is a two-phase constructor method that is used to create a new instance for listening to the changes in all keys in the repository.

Leaves the constructed instance to cleanup stack.

Type specific callback methods of MCenRepNotifyHandlerCallback will not be used when notifying about changes in this case, only HandleNotifyGeneric() is used.

Parameters:

	aCallback	Reference to a callback instance.
	aSession	Reference to an existing repository session. Do not close this session until all CCenRepNotifyHandler instances referring to it have been deleted.

Returns:: A pointer to a new instance of the CCenRepNotifyHandler class.

static IMPORT_C CCenRepNotifyHandler* CCenRepNotifyHandler::NewLC	(	MCenRepNotifyHandlerCallback &	aCallback,
		CRepository &	aSession,
		TCenRepKeyType	aKeyType,
		TUint32	aId
	)	`[static]`

This is a two-phase constructor method that is used to create a new instance for listening to the changes in a single key.

Leaves the constructed instance to cleanup stack.

Parameters:

	aCallback	Reference to a callback instance.
	aSession	Reference to an existing repository session. Do not close this session until all CCenRepNotifyHandler instances referring to it have been deleted.
	aKeyType	Type of the key identified by aId parameter.
	aId	Id of the key that change notifications are needed for.

Returns:: A pointer to a new instance of the CCenRepNotifyHandler class.

Leave:: KErrArgument if invalid key type is passed as a parameter.

TInt CCenRepNotifyHandler::RunError ( TInt aError ) [protected]

Implements CActive.

Parameters:

aError

the error returned

Returns:: error

void CCenRepNotifyHandler::RunL ( ) [protected]

Implements CActive.

Parameters:

none

Returns:: none

IMPORT_C void CCenRepNotifyHandler::StartListeningL

(

)

When this method is called, the CCenRepNotifyHandler starts listening for notifications.

If it is already listening, nothing happens.

Leave:: KErrAlreadyExists if there is already a notification on same CRepository for this setting, or an error from IPC or server side resource allocation failure.

IMPORT_C void CCenRepNotifyHandler::StopListening

(

)

When this method is called, the CCenRepNotifyHandler stops listening for notifications.

If it is already stopped, nothing happens.

The documentation for this class was generated from the following file:

cenrepnotifyhandler.h

CCenRepNotifyHandler Class Reference

Capability Information

Detailed Description

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation