/*
* Copyright (c) 2009 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:   ?Description
*
*/



#ifndef IA_UPDATE_ENGINE_XML_SUB_PARSER_H
#define IA_UPDATE_ENGINE_XML_SUB_PARSER_H


#include "iaupdatexmlsubparser.h"

class CIAUpdateEngineConfigData;


/**
 * CIAUpdateEngineXmlSubParser parses the engine configuration data.
 *
 * @since S60 v3.2
 */
class CIAUpdateEngineXmlSubParser : public CIAUpdateXmlSubParser
    {

public:
    
    /**
     * @param aConfigData This config data will contain engine information that is
     * parsed from the elements that are handled by this sub parser.
     * @return CIAUpdateEngineXmlSubParser* Created object.
     *
     * @since S60 v3.2
     */
    static CIAUpdateEngineXmlSubParser* NewL( CIAUpdateEngineConfigData& aConfigData );

    /**
     * @see CIAUpdateEngineXmlSubParser::NewL
     *
     * @since S60 v3.2
     */
    static CIAUpdateEngineXmlSubParser* NewLC( CIAUpdateEngineConfigData& aConfigData );


    /**
     * Destructor
     *
     * @since S60 v3.2
     */
    virtual ~CIAUpdateEngineXmlSubParser();


    /**
     * @note If parsing has not been done before calling this function,
     * the returned object contains only default values.
     *
     * @return const CIAUpdateEngineConfigData& Config data.
     *
     * @since S60 v3.2
     */
    const CIAUpdateEngineConfigData& ConfigData() const;
    

public: // CIAUpdateXmlSubParser 

    /**
     * @see CIAUpdateXmlSubParser::OnStartElementL
     *
     * @since S60 v3.2
     */    
    virtual void OnStartElementL( const Xml::RTagInfo& aElement, 
                                  const Xml::RAttributeArray& aAttributes, 
                                  TInt aErrorCode );


protected:
    
    /**
     * Constructor
     *
     * @see CIAUpdateEngineXmlSubParser::NewL
     *
     * @since S60 v3.2
     */
    CIAUpdateEngineXmlSubParser( CIAUpdateEngineConfigData& aConfigData );
    
    /**
     * 2nd. phase constructor.
     *
     * @since S60 v3.2
     */
    virtual void ConstructL();


private:
    
    // Prevent these if not implemented
    CIAUpdateEngineXmlSubParser( const CIAUpdateEngineXmlSubParser& aObject );
    CIAUpdateEngineXmlSubParser& operator =( const CIAUpdateEngineXmlSubParser& aObject );

    // Funtions that hande the attributes of different elements and insert the
    // values into the configuration data object.

    void HandleStorageAttributesL( const Xml::RAttributeArray& aAttributes );
    void HandleMasterServerAttributesL( const Xml::RAttributeArray& aAttributes );
    void HandleProvisioningAttributesL( const Xml::RAttributeArray& aAttributes );
    void HandleClientRoleAttributesL( const Xml::RAttributeArray& aAttributes );


private: // data

    CIAUpdateEngineConfigData& iConfigData;
    
    };

#endif // IA_UPDATE_ENGINE_XML_SUB_PARSER_H