diff -r 000000000000 -r 72b543305e3a mmsengine/mmswatcher/inc/mmscenrepobserver.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/mmsengine/mmswatcher/inc/mmscenrepobserver.h Thu Dec 17 08:44:11 2009 +0200 @@ -0,0 +1,132 @@ +/* +* Copyright (c) 2004 Nokia Corporation and/or its subsidiary(-ies). +* All rights reserved. +* This component and the accompanying materials are made available +* under the terms of "Eclipse Public License v1.0" +* which accompanies this distribution, and is available +* at the URL "http://www.eclipse.org/legal/epl-v10.html". +* +* Initial Contributors: +* Nokia Corporation - initial contribution. +* +* Contributors: +* +* Description: +* This class observes given cenrep value. +* +*/ + + + +#ifndef CMMSCENREPOBSERVER_H +#define CMMSCENREPOBSERVER_H + +// INCLUDES +#include +#include +#include + +// CONSTANTS +// MACROS +// DATA TYPES +// FUNCTION PROTOTYPES +// FORWARD DECLARATIONS +// CLASS DECLARATION + +/** +* Interface for requster +*/ +class MMmsCenRepNotifyHandler + { + public: // New functions + /** + * Callback for timer cancellation + * @param aRepositoryUid identifies the repository where the key under + * observation is located. + * @param aKey identifies the particular key under observation. + * @param aValue specifies the new changed value of the key. + */ + virtual void HandleCenRepNotificationL( + const TUid aRepositoryUid, + const TInt32 aKey, + const TInt aValue ) = 0; + }; + +/** +* Class for observing a particular CenRep value +*/ +class CMmsCenRepObserver : public CActive + { + public: // Constructors and destructor + + /** + * Two-phased constructor. + * @param aRConnection opened RConnection + */ + static CMmsCenRepObserver* NewL(); + + /** + * Destructor. + */ + virtual ~CMmsCenRepObserver(); + + public: // New functions + + /** + * Subscribe to a particular key in CenRep + * @param aRepositoryUid identifies the repository where the key under + * observation is located. + * @param aKey identifies the particular key under observation. + * @param aRequester pointer to notification handler + */ + void SubscribeNotification( + const TUid aRepositoryUid, + const TInt32 aKey, + MMmsCenRepNotifyHandler* aRequester ); + + public: // Functions from base classes + + protected: // New functions + + protected: // Functions from base classes + + /** + * Active object cancellation + */ + void DoCancel(); + + private: + + /** + * C++ default constructor. + */ + CMmsCenRepObserver(); + + /** + * By default Symbian OS constructor is private. + * @param aRConnection opened RConnection + */ + void ConstructL(); + + /** + * Completion + */ + void RunL(); + + // By default, prohibit copy constructor + CMmsCenRepObserver( const CMmsCenRepObserver& ); + + // Prohibit assignment operator + CMmsCenRepObserver& operator= ( const CMmsCenRepObserver& ); + + private: // Data + + MMmsCenRepNotifyHandler* iRequester; + CRepository* iRepository; + TUid iRepositoryUid; + TInt32 iKey; + }; + +#endif // CMMSCENREPOBSERVER_H + +// End of File