/*
* 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:  Class definition of VoIP XML parameter handler.
*
*/


#ifndef VOIPXMLPARAMHANDLER_H
#define VOIPXMLPARAMHANDLER_H

#include <e32base.h>

class CVoipXmlSipHandler;
class CVoipXmlVoipHandler;
class CVoipXmlXdmHandler;
class CVoipXmlPresenceHandler;
class CVoipXmlNatFwHandler;
class CVoipXmlIapHandler;

/**
*  CVoipXmlParamHandler 
*  Handles parameters and passes them to settings handlers.
* 
*  @lib voipxmlprocessor.lib
*  @since S60 v5.0
*/
NONSHARABLE_CLASS( CVoipXmlParamHandler ) : public CBase
    {
#ifdef _DEBUG
    friend class UT_CVoipXmlParamHandler;
    friend class UT_CVoipXmlParser;
#endif

public:

    static CVoipXmlParamHandler* NewL();
    
    static CVoipXmlParamHandler* NewLC(); 

    virtual ~CVoipXmlParamHandler();

    /**
     * Marks what type of settings are to be deployed.
     * 
     * @since S60 v5.0
     * @param aType Type of settings that are to be deployed.
     */
    void SettingsStart( const TDesC& aType );

    /**
     * Tells that settings are deployed and previous type should be used. 
     */
    void SettingsEnd();

    /**
     * Handles XML parameters and passes the handled
     * ones to settings handlers.
     * 
     * @since S60 v5.0
     * @param aParam Parameter name.
     * @param avalue Parameter value.
     */
    void HandleParameter( const TDesC& aParam, const TDesC& aValue );

    /**
     * Stores transiently saved settings.
     *
     * @since S60 v5.0
     * @return KErrNone if successful,
     *         KErrNotSupported if no SIP or VoIP settings to be stored,
     *         KErrCompletion if error occurred in storing settings.
     */
    TInt StoreSettings();

    /**
     * Returns the service tab ID.
     * 
     * @since S60 v5.0
     * @return Service tab ID.
     */
    TUint32 ServiceTabId();

private:

    /**
     * Converts parameter name to enumerated one.
     *
     * @since S60 v5.0
     * @param aParam Parameter name.
     * @return Enumerated parameter value.
     */
    TInt ConvertParameter( const TDesC& aParam );

private:

    CVoipXmlParamHandler();

    void ConstructL();

    
private: // data

    /**
     * Type of settings that are currently being deployed.
     */
    TInt iSettingsType;

    /**
     * Type of previously deployed settings.
     */
    TInt iPreviousSettingsType;

    /**
     * SIP settings handler.
     * Own.
     */
    CVoipXmlSipHandler* iSipHandler;

    /**
     * VoIP settings handler.
     * Own.
     */
    CVoipXmlVoipHandler* iVoipHandler;

    /**
     * XDM settings handler.
     * Own.
     */
    CVoipXmlXdmHandler* iXdmHandler;

    /**
     * Presence settings handler.
     * Own.
     */
    CVoipXmlPresenceHandler* iPresenceHandler;

    /**
     * NAT/Firewall settings handler.
     * Own.
     */
    CVoipXmlNatFwHandler* iNatFwHandler;

    /**
     * Internet Access Point settings handler.
     * Own.
     */
    CVoipXmlIapHandler* iIapHandler;
    };

#endif // VOIPXMLPARAMHANDLER_H

// End of File