/*

* 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 client settings API implementation class.

*

*/

#ifndef PSMSETTINGSIMPL_H

#define PSMSETTINGSIMPL_H

#include <e32base.h>

#include <psmsettings.h>

#include "psmsession.h"

/**

 *  PSM settings API class.

 *

 *  Implementents power save mode client settings API.

 *

 *  @since S60 5.0

 */

NONSHARABLE_CLASS( CPsmSettingsImpl ) : public CPsmSettings

    {

    friend class CPsmSettings;

    public:  // Constructors and destructor

        /**

         * Destructor.

         */

        virtual ~CPsmSettingsImpl();

        /**

         * C++ constructor.

         */

        CPsmSettingsImpl( RPsmServer& aPsmServer );

    public: // API methods

        /**

         * Changes the values. Backups current settings and returns changeable settings

         *

         * @since S60 5.0

         * @param[in, out] aPsmConfigArray Contains current settings, on exit, contains updated settings

         * @param[in] aRepository Specific reposiroty UID where these settings are in

         * @return A system wide error code.

         */

        TInt BackupAndGetSettings( RConfigInfoArray& aPsmConfigArray, const TUint32 aRepository );

        /**

         * Gets configuration set for current mode without doing any backups or changing any values.

         * Only reads configurations for currently active power save mode. If current mode is not

         * a power save mode, returns empty array.

         *

         * @param[in, out] aPsmConfig Pre-filled configuration info. Must contain at least config identification

         * @param[in] aRepository Specific reposiroty UID where these settings are in

         * @return A system wide error code

         */

        TInt GetSettings( RConfigInfoArray& aPsmConfigArray, const TUint32 aRepository );

        /**

         * Backups settings that exists in aPsmConfigArray. Note that any existing config information

         * with same config Id in aRepository is overriden with new values from aPsmConfigArray.

         *

         *

         * @param[in, out] aPsmConfigArray Contains current settings, on exit, contains updated settings

         * @param[in] aRepository Specific reposiroty UID where these settings are in

         * @return A system wide error code

         */

        TInt BackupSettings( RConfigInfoArray& aPsmConfigArray, const TUint32 aRepository );

        /**

         * Gives currently active power save mode. If mode change is ongoing, gives the PSM mode for which 

         * is changing.

         *

         * @return TPsmsrvMode Currently active mode

         */

        TInt GetCurrentMode( TInt& aMode );

    private:

        /**

         * C++ constructor.

         */

        CPsmSettingsImpl();

        /**

         * Symbian 2nd phase constructor.

         */

        void ConstructL();

        /**

         * Handles settings related requests

         */

        TInt HandleSettingsRequest( RConfigInfoArray& aPsmConfigArray, 

                                    const TUint32 aRepository,

                                    const TPsmServerRequest aRequest );

        /**

         * Updates config array

         */

        void UpdateConfigArray( RConfigInfoArray& aTargetArray, 

                                RConfigInfoArray& aSourceArray );

    private: // data

        /**

         * Client-server session to PSM server.

         */

        RPsmServer iPsmServer;

        /**

         * Indicates is iPsmServer owned

         */

        TBool iOwnSession;

    };

#endif // PSMSETTINGSIMPL_H