/*

* Copyright (c) 2007 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:  PSM settings handler class.

*

*/

#ifndef PSMSETTINGSHANDLER_H

#define PSMSETTINGSHANDLER_H

#include <e32base.h>

#include <psmsettingsprovider.h>

// FORWARD DECLARATIONS

class CPsmStorage;

class CPsmConfigStorage;

class CPsmCenRepStorage;

class CPsmBackupStorage;

/**

 *  PSM Settings handler class

 *

 *  Handles settings related events during power save mode change

 *

 *  @since S60 5.0

 */

class CPsmSettingsHandler : public CBase,

                            public MPsmSettingsProvider

    {

    public:  // Constructors and destructor

        /**

         * Creates a new PSM settings handler.

         *

         * @since S60 5.0

         * @param aMode Mode where to swith to

         * @return A pointer to the created object.

         */

        static CPsmSettingsHandler* NewL( TPsmsrvMode aMode );

        /**

         * Creates a new PSM settings handler. Newly created instance is left in the cleanup stack.

         *

         * @since S60 5.0

         * @param aMode Mode where to swith to

         * @return A pointer to the created object.

         */

        static CPsmSettingsHandler* NewLC( TPsmsrvMode aMode );

        /**

         * Destructor.

         */

        virtual ~CPsmSettingsHandler();

        /**

         * From MPsmSettingsProvider. Changes the settings

         */

        void BackupAndGetSettingsL( RConfigInfoArray& aPsmConfigArray, const TUint32 aRepository );

        /**

         * From MPsmSettingsProvider. Gets configuration set for current PSM mode

         */

        void GetSettingsL( RConfigInfoArray& aPsmConfigArray, const TUint32 aRepository );

        /**

         * From MPsmSettingsProvider. Creates backup for configuration set.

         */

        void BackupSettingsL( const RConfigInfoArray& aPsmConfigArray, const TUint32 aRepository );

        /**

         * Changes CenRep keys

         */

        void ChangeCenRepSettingsL();

        /**

         * Sets new mode

         */

        void SetMode( TPsmsrvMode aMode ); 

        /**

         * Returns mode where to switch to

         */

        TPsmsrvMode Mode() { return iMode; };

        /**

         * Returns current mode before mode change

         */

        TPsmsrvMode PreviousMode() const { return iCurrentMode; };

    private:

        /**

         * C++ constructor.

         * @param aMode Mode where to swith to

         */

        CPsmSettingsHandler( TPsmsrvMode aMode );

        /**

         * By default Symbian 2nd phase constructor is private.

         */

        void ConstructL();

        /**

         * Changes CenRep keys

         */

        void ChangeCenRepSettingsL( RConfigInfoArray& aPsmConfigArray, TUint32 aRepository );

        /**

         * Compares current settings to new settings, creates backup and returns 

         * new settings

         * 

         * @param aConfigStorage Storage where to get new config values

         * 

         */

        void ChangeSettingsL( RConfigInfoArray& aPsmConfigArray, 

                              TUint32 aRepository,

                              CPsmStorage& aConfigStorage );

        /**

         * Compares two configuration informations

         */ 

        TBool Compare( const TPsmsrvConfigInfo& aSource, const TPsmsrvConfigInfo& aTarget ) const;

    private:    // Data

        /**

         * Mode where to switch to

         */

        TPsmsrvMode iMode;

        /**

         * Mode before PSM change completed

         */

        TPsmsrvMode iCurrentMode;

        /**

         * Handle to file server session

         */

        RFs iFileSession;

        /**

         * Storage file handlers

         */

        CPsmConfigStorage* iConfigStorage;

        CPsmBackupStorage* iBackupStorage;

        CPsmCenRepStorage* iCenRepStorage;

    };

#endif // PSMSETTINGSHANDLER_H