diff -r 000000000000 -r ba25891c3a9e iaupdate/IAD/engine/controller/inc/iaupdateenginexmlparser.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/iaupdate/IAD/engine/controller/inc/iaupdateenginexmlparser.h Thu Dec 17 08:51:10 2009 +0200 @@ -0,0 +1,122 @@ +/* +* 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