/*
* 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_PARSER_H
#define IA_UPDATE_ENGINE_XML_PARSER_H
#include "iaupdatexmlparser.h"
class CIAUpdateEngineXmlSubParser;
class CIAUpdateEngineConfigData;
/**
* CIAUpdateEngineXmlParser parses the configuration data from
* engine config file.
*
* @since S60 v3.2
*/
class CIAUpdateEngineXmlParser : public CIAUpdateXmlParser
{
public:
/**
* @return CIAUpdateEngineXmlParser* Created object.
*
* @since S60 v3.2
*/
static CIAUpdateEngineXmlParser* NewL();
/**
* @see CIAUpdateEngineXmlParser::NewL
*
* @since S60 v3.2
*/
static CIAUpdateEngineXmlParser* NewLC();
/**
* Destructor
*
* @since S60 v3.2
*/
virtual ~CIAUpdateEngineXmlParser();
/**
* Parses the data from the configuration file and inserts the values
* into the configuration data object. This done synchronously.
*
* @since S60 v3.2
*/
virtual void ParseL();
/**
* @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;
protected:
/**
* Constructor
*
* @see CIAUpdateEngineXmlParser::NewL
*
* @param aSubParser Sub parser that will handle the XML elements.
* NULL value is NOT accepted here. Ownership is transferred.
* @param aConfigData Config data that will contain all the parsed data.
* NULL value is NOT accepted here. Ownership is transferred.
*
* @since S60 v3.2
*/
CIAUpdateEngineXmlParser( CIAUpdateEngineXmlSubParser* aSubParser,
CIAUpdateEngineConfigData* aConfigData );
/**
* 2nd. phase constructor.
*
* @since S60 v3.2
*/
virtual void ConstructL();
private:
// Prevent these if not implemented
CIAUpdateEngineXmlParser( const CIAUpdateEngineXmlParser& aObject );
CIAUpdateEngineXmlParser& operator =( const CIAUpdateEngineXmlParser& aObject );
private: // data
CIAUpdateEngineConfigData* iConfigData;
};
#endif // IA_UPDATE_ENGINE_XML_SUB_PARSER_H