/*
* Copyright (c) 2005 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:  IMPS SAP Settings Store implementation.
*
*/


#ifndef CIMPSSAPCENREP_H
#define CIMPSSAPCENREP_H

//  INCLUDES
#include <e32base.h>
#include <commdb.h>

#include "impssapsettings.h"

//Encryption & decryption passwords has been removed
//401-1808 - Ease of Instant Messaging SERVER customization


// FORWARD DECLARATIONS

class CRepository;
class CIMPSSAPSettings;
class CIMPSSAPSettingsList;
class CIMPSSAPNotifier;
class MIMPSSAPObserver;

// CLASS DECLARATION

/**
*  Implementation for CIMPSSAPSettingsStore.
*  Uses central repository for storing SAP data.
*
*  @see CIMPSSAPSettingStore
*  @lib WVSAPSettings.dll
*  @since 3.0
*/
NONSHARABLE_CLASS( CIMPSSAPCenRep ): public CBase
    {
public:  // Constructors and destructor

    /**
    * Two-phased constructor.
    * @param aPriority Priority for active object based store event
    *        notifier. This determines priority of notifying store
    *        event observers.
    */
    static CIMPSSAPCenRep* NewL( TInt aPriority );
    static CIMPSSAPCenRep* NewLC( TInt aPriority );

    /**
    * Destructor.
    */
    virtual ~CIMPSSAPCenRep();


public: // Implemented methods for CIMPSSAPSettingsStore

    /**
     * @see CIMPSAPSettingsStore for description of these methods.
     *
     * @since 3.0
     */

    // Observer support

    void AddObserverL( MIMPSSAPObserver* aObserver, TIMPSAccessGroup aGroup );
    void RemoveObserver( MIMPSSAPObserver* aObserver );

    // SAP Settings related

    TUint32 StoreNewSAPL( CIMPSSAPSettings* aSAPSettings, TIMPSAccessGroup aGroup );
    void GetSAPL( TUint32 aUid, CIMPSSAPSettings* aSAPSettings );
    void DoGetSAPL( TUint32 aUid, CIMPSSAPSettings* aSAPSettings );
    TInt SAPCountL( TIMPSAccessGroup aGroup );
    void DeleteSAPL( TUint32 aUid );
    void UpdateOldSAPL( CIMPSSAPSettings* aSAPSettings, TUint32 aUid );
    void PopulateSAPSettingsListL( CIMPSSAPSettingsList& aList,
                                   TIMPSAccessGroup aGroup,
                                   TBool aAscending = ETrue );

    // Default SAP

    void GetDefaultL( TUint32& aUid, TIMPSAccessGroup aGroup );
    void GetDefaultL( CIMPSSAPSettings* aSAPSettings, TIMPSAccessGroup aGroup );
    void SetToDefaultL( TUint32 aUid, TIMPSAccessGroup aGroup );

private: //Constructors

    /**
    * C++ default constructor.
    */
    CIMPSSAPCenRep();

    /**
    * By default Symbian 2nd phase constructor is private.
    *
    * @param aPriority Priority for active object based store event
    *        notifier. This determines priority of notifying store
    *        event observers.
    */
    void ConstructL( TInt aPriority );

private: //Helper methods

    /**
     * Calculates cenrep Id for a setting using bitmasks.
     *
     * @param aSetting The enumerated setting value to use in calculation
     * @param aUid Uid of the SAP.
     * @param aGroup Access group of the SAP
     * @return The calculated Id
     * @since 3.0
     */
    TUint32 MaskedId( TInt aSetting, TUint32 aUid, TIMPSAccessGroup aGroup );

    /**
     * Checks if SAP with given name already exists.
     *
     * @param aSAPName Name of the SAP to be checked
     * @param aUid SAP's name in SAP with this Uid is allowed to be duplicate
     *		  to enable updating of existing SAPs
     * @param aGroup Access group which within the check is made
     * @return ETrue if name already exists, otherwise EFalse
     * @since 3.0
     */

    TBool SAPNameExistsL( const TDesC& aSAPName, TUint32 aUid, TIMPSAccessGroup aGroup );

    /**
     * Checks if SAP exists in the central repository. Leaves
     * wíth KErrNotFound if SAP does not exist.
     *
     * @param aUid Uid to check
     * @since 3.0
     */

    void SAPExistsL( TUint32 aUid );

    /**
     * Gets new unique uid for storing new SAP.
     *
     * @return New Uid, leaves with KErrInUse if all Uids are in use
     * @since 3.0
     */

    TUint32 NewUidL();

    /**
     * Gets SAP access group .
     *
     * @param aUid Uid of the SAP for getting access group
     * @return SAP access group
     * @since 3.0
     */

    TIMPSAccessGroup SAPTypeL( TUint32 aUid );

    /**
     * Gets SAP protection level.
     *
     * @param aUid Uid of the SAP for getting protection
     * @param aGroup SAP's access group
     * @return SAP protection level
     * @since 3.0
     */

    TIMPSSAPProtection SAPProtectionL( TUint32 aUid, TIMPSAccessGroup aGroup );

    /**
     * Sets up default SAP ids if they do not exist in the repository.
     *
     * @since 3.0
     */

    void SetUpDefaultsL();

    /**
     * Finds existing SAP ids from desired access group and populates them
     * to an array.
     *
     * @param aGroup desired access group
     * @param aFoundSAPs array for storing found SAP ids
     * @since 3.0
     */

    void FindSAPsFromAccessGroupL( TIMPSAccessGroup aGroup,
                                   RArray<TUint32>& aFoundSAPs );

    /**
     * Starts new transaction if there is no ongoing transaction.
     *
     * @param aMode Transaction mode
     * @since 3.0
     */

		TBool StartOwnTransactionL( TInt aMode );

    /**
     * Converts Access Point Name into AP value
     * Configurability req.
     * 401-1808 - Ease of Instant Messaging SERVER customization
     * @param aAPName - AP name
     * @return AP Number in the Commnection DB
     * @since 5.0
     */

    TUint32 DoGetAccessPointsL( const TDesC& aAPName );


    /**
     * Converts Access Point Number into AP Name value
     * Configurability req.
     * 401-1808 - Ease of Instant Messaging SERVER customization
     * @param aAP - AP Number in the Commnection DB
     * @return HBufC AP name, Caller should free this data.
     * @since 5.0
     */
    HBufC* DoGetAccessPointsNameL( const TUint32 aAP );

		/**
		* Reset iInTransaction state by invoke ReSetTransactionFlag(). 
		* This happens when iRepository is not committed and leave occurred.
		* @param aAP - Instance of this class
		*/		
		static void ReSetTransactionState(TAny* aPtr);

		/**
		* Reset iInTransaction flag
		*/	
		void ReSetTransactionFlag();

    /**
     * Unit test class is a friend class.
     */
    friend class T_CIMPSSAPSecurity;	// CSI: 36 #

private:    // Data
    CRepository* iRepository; // Handle to central repository session (own)
    CIMPSSAPNotifier* iNotifier; // SAP Settings notifier (own)
    CCommsDatabase* iCommsDatabase; //Accesses the communications database
    TBool iInTransaction;
    };

#endif      // CIMPSSAPCENREP_H

// End of File