/*
* Copyright (c) 2009-2010 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:  XDM handler for VoIP XML processor
*
*/


#ifndef  VOIPXMLXDMHANDLER_H
#define  VOIPXMLXDMHANDLER_H


class CXdmSettingsCollection;

/**
*  VoipXmlXdmHandler
*  XDM handler class.
* 
*  @lib voipxmlprocessor.lib
*  @since S60 v5.0
*/
class CVoipXmlXdmHandler : public CBase
    {
#ifdef _DEBUG
    friend class UT_CVoipXmlXdmHandler;
    friend class UT_CVoipXmlParamHandler;
#endif

public:

    static CVoipXmlXdmHandler* NewL();
    ~CVoipXmlXdmHandler();

public:

    /**
     * Sets XDM setting.
     *
     * @since S60 v5.0
     * @param aParam Parameter to be set.
     * @param aValue Value of the setting.
     */
    void SetSetting( TInt aParam, const TDesC& aValue );

    /**
     * Stores settings to 'XDM registry', i.e. creates an XDM collection.
     *
     * @since S60 v5.0
     * @return KErrNone if successful,
     *         KErrNotSupported if no settings to be stored,
     *         KErrCompletion if settings could not be stored.
     */
    TInt StoreSettings();

    /**
     * Returns the settings ID.
     *
     * @since S60 v5.0
     * @return XDM settings ID.
     */
    TUint32 SettingsId();

private:

    /**
     * Sets XDM setting.
     *
     * @since S60 v5.0
     * @param aParam Parameter to be set.
     * @param aValue Value of the setting.
     */
    void SetSettingL( TInt aParam, const TDesC& aValue );

    /**
     * Creates a provider name for XDM profile. aName is used
     * and replaced with a parenthised ordered number if the name is
     * already found in XDM storage.
     *
     * @since S60 v5.0
     * @param aName Provider name to be set.
     */
    void CreateProviderNameL( TDes& aName );

private:

    CVoipXmlXdmHandler();
    void ConstructL();

private:

    /**
     * XDM settings collection object.
     * Own.
     */
    CXdmSettingsCollection* iProfile;

    /**
     * Tells if any settings have been set to temporary profile.
     */
    TBool iSettingsSet;

    /**
     * XDM collection ID.
     */
    TUint32 iProfileId;
    };

#endif // VOIPXMLXDMHANDLER_H

// End of file.