/*
* 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:  Manages always-on settings in Central Repository.
*
*/


#ifndef NSMLDMALWAYSONSETTINGSTORE_H
#define NSMLDMALWAYSONSETTINGSTORE_H

#include "nsmldmalwaysonadapter.h"

#include <centralrepository.h>

const TInt KDefaultLuid = 1;

class CNSmlDmAOAdapter;
class CSmlDmAOCommandElement;

/**
 *  Setting Store is used for managing settings in CentralRepository
 *
 *  The class provides functions for executing commands 
 *  and sets of commands that involve manipulation of 
 *  data in CentralRepository. 
 *
 *  @lib nsmldmalwaysonadapter
 *  @since S60 v3.2
 */
class CNSmlDmAOSettingStore : public CBase
    {

public:

    static CNSmlDmAOSettingStore * NewL( CNSmlDmAOAdapter* aAdapter );

    virtual ~CNSmlDmAOSettingStore();

    /**
     * Executes the argument command. 
     *
     * @since S60 v3.2
     * @param aCmd Command to be executed
     * @param aLUID LUID of the VENDORCONFIG which command is referring.
     */
     void ExecuteCmdL( CSmlDmAOCommandElement& aCmd, TUint aLuid);   

    /**
     * Fetches all VENDORCONFIGs and inserts id of each VENDORCONFIG
     * into the argument array (in practise there is only one VENDORCONFIG)
     *
     * @since S60 v3.2
     * @param aLUIDArray Array for VENDORCONFIG ids
     */
    void GetVendorConfigsL( RArray<TUint32>& aLUIDArray );
 
private:

    CNSmlDmAOSettingStore( CNSmlDmAOAdapter * aAdapter );

    void ConstructL();

//----------- Commands for managing leaf nodes -------------------//

    /**
     * Executes VENDORCONFIG commands. The valid commands include 
     * get. With get commands the iData 
     * memeber is used to pass fetched data back to caller. 
     * After execution of command the function fills in the status 
     * in aCmd.iStatus memeber and sets aCmd.iExecuted as True. The function
     * leaves if command can not be executed for some reason. 
     *
     * @param aCmd The command to be executed
     * @param aLuid The id of the VENDORCONFIG
     */
    void ExecuteVendorConfigCmdL( CSmlDmAOCommandElement& aCmd, TUint aLuid );    

    /**
     * Executes NAME commands. The valid commands include 
     * update and get. With update commands data is read from the 
     * iData memeber of the argument command. With get commands the iData 
     * memeber is used to pass fetched data back to caller. 
     * After execution of command the function fills in the status 
     * in aCmd.iStatus memeber and sets aCmd.iExecuted as True. The function
     * leaves if command can not be executed for some reason. 
     *
     * @param aCmd    The command to be executed
     * @param aCenrep Pointer to PdpContextManager2 repository
     */
    void ExecuteNameCmdL( CSmlDmAOCommandElement& aCmd, 
                          CRepository*            aCenrep );


    /**
     * Executes AWON-PDPC commands. The valid commands include 
     * update and get. With update commands data is read from the 
     * iData memeber of the argument command. With get commands the iData 
     * memeber is used to pass fetched data back to caller. 
     * After execution of command the function fills in the status 
     * in aCmd.iStatus memeber and sets aCmd.iExecuted as True. The function
     * leaves if command can not be executed for some reason. 
     *
     * @param aCmd The command to be executed
     * @param aCenrep Pointer to PdpContextManager2 repository
     */
    void ExecuteAwonPdpcCmdL( CSmlDmAOCommandElement& aCmd, 
                              CRepository*            aCenrep );


    /**
     * Executes T-RETRY commands. The valid commands include 
     * update and get. With update commands data is read from the 
     * iData memeber of the argument command. With get commands the iData 
     * memeber is used to pass fetched data back to caller. 
     * After execution of command the function fills in the status 
     * in aCmd.iStatus memeber and sets aCmd.iExecuted as True. The function
     * leaves if command can not be executed for some reason. 
     *
     * @param aCmd The command to be executed
     * @param aCenrep Pointer to PdpContextManager2 repository
     */
    void ExecuteTRetryCmdL( CSmlDmAOCommandElement& aCmd, 
                            CRepository*            aCenrep );
    
     /**
     * Parses integer from descriptor 
     *
     * @param aPtr Descriptor containing value
     * @param aInt Value as integer
     */                        
    void ParseIntegerL( const TDesC& aPtr, TInt& aInt );
    
     /**
     * Parses settings for home network and visited network 
     *
     * @param aInt Interger containing home & visited network setting
     * @param aHplmn "1" when always-on enabled in hplmn, otherwise "0"
     * @param aVplmn "1" when always-on enabled in vplmn, otherwise "0"
     */
    void ParseAwonPdpcValuesL( const TInt aInt, TInt& aHplmn, TInt& aVplmn );                        

private: //data
     
    /**
     * Pointer to the adapter. This is used for 
     * querying data from DM framework when necessary
     * and using helper functions. Not own.
     */ 
    CNSmlDmAOAdapter* iAdapter;

  };


#endif // NSMLDMALWAYSONSETTINGSTORE_H