/*
* Copyright (c) 2006-2006 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:  Gets and notifies backup and Restore events from system
*
*/


#ifndef CBSBACKUPOBSERVER_H
#define CBSBACKUPOBSERVER_H

#include <e32base.h>
#include <e32property.h>

#include "mbsbackupobserver.h"

/**
 *  Gets and notifies backup and Restore events from system
 *
 *  @lib bsserver.exe
 *  @since S60 v3.2
 */
class CBSBackupObserver : public CActive
{
public:

    static CBSBackupObserver* NewL();

    static CBSBackupObserver* NewLC();

    ~CBSBackupObserver();


private: // From CActive

    /**
     * @see CActive
     */
    void RunL();
    
    /**
     * @see CActive
     */
    void DoCancel();
    
    /**
     * @see CActive
     */
    TInt RunError( TInt aError );


private: // Private constructors

    CBSBackupObserver();

    void ConstructL();


public: // New Methods

    /**
     * Register observer to observe backup state changes
     * @param aObserver observer to register
     * @return KErrNone or some other system wide errorcode
     */
    TInt RegisterObserver( MBSBackupObserver* aObserver );
    
    /**
     * Unregister observer
     * @param aObserver observer to remove
     */
    void UnregisterObserver( MBSBackupObserver* aObserver );   


private: // New methods

    /**
     * Subscribes to backup and restore P&S value.
     */
    void Subscribe();
    
    /**
     * Notify registered observers of new backup state
     */
    void NotifyObserversL( MBSBackupObserver::TBackupState aState );
    
    /**
     * Read current backup state
     * @return current backup state
     */
    MBSBackupObserver::TBackupState BackupStateL();


private: // Data

    // backup state property
    RProperty iProperty;
    
    // Own (array only). Observers
    RPointerArray<MBSBackupObserver> iObservers;
    
    // latest state of backup and restore;
    MBSBackupObserver::TBackupState iLatestState;
};

#endif //CBSBACKUPOBSERVER_H