/*

* Copyright (c) 2006 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:   CNcdConfigurationParser declaration

*

*/

#ifndef C_NCDCONFIGURATIONPARSER_H

#define C_NCDCONFIGURATIONPARSER_H

#include <xml/parser.h>

#include <xml/contenthandler.h>

#include <xml/documentparameters.h>

#include <xml/taginfo.h>

#include <xml/attribute.h>

/**

 * Observer interface for a configuration observer

 */ 

class MNcdConfigurationParserObserver

    {

public:

    /**

     * Called when starting to parse a new element

     *

     * @param aElement Name of the element

     */ 

    virtual void ConfigurationElementStartL(

        const TDesC8& aElement ) 

        {

        (void) aElement;

        }

    /**

     * Called after an element has been parsed

     *

     * @param aElement Name of the parsed element

     * @param aData Data included in the element

     */    

    virtual void ConfigurationElementEndL( 

        const TDesC8& aElement, 

        const TDesC8& aData ) = 0;

    /**

     * Called for each attribute in an element

     *

     * @param aElement Element that is being parsed

     * @param aAttribute Name of the attribute

     * @param aValue Value of the attribute

     */

    virtual void ConfigurationAttributeL( 

        const TDesC8& aElement, 

        const TDesC8& aAttribute, 

        const TDesC8& aValue ) = 0;

    /**

     * Called when a parse error occurs

     */    

    virtual void ConfigurationError( TInt aError ) = 0;

protected:

    /**

     * Destructor

     */

    virtual ~MNcdConfigurationParserObserver()

        {

        }

    };

/**

 * Provider configuration parser

 */

class CNcdConfigurationParser : public CBase,

                                public Xml::MContentHandler

    {

public:

    /**

     * NewL

     * @param aObserver Observer for parsing events

     */

    static CNcdConfigurationParser* NewL( 

        MNcdConfigurationParserObserver& aObserver );

    /**

     * NewLC

     * @param aObserver Observer for parsing events

     */

    static CNcdConfigurationParser* NewLC( 

        MNcdConfigurationParserObserver& aObserver );

    /**

     * Destructor

     */

    virtual ~CNcdConfigurationParser();

public: // New methods

    /**

     * Parses given data

     *

     * @param aData Data to parse

     */

    void ParseL( const TDesC16& aData );    

    /**

     * Parses given data

     *

     * @param aData Data to parse

     */

    void ParseL( const TDesC8& aData );    

public: // From Xml::MContentHandler

    void OnStartDocumentL(const Xml::RDocumentParameters& aDocParam, 

        TInt aErrorCode);

    void OnEndDocumentL(TInt aErrorCode);

    void OnStartElementL(const Xml::RTagInfo& aElement, 

        const Xml::RAttributeArray& aAttributes, TInt aErrorCode);

    void OnEndElementL(const Xml::RTagInfo& aElement, TInt aErrorCode);

    void OnContentL(const TDesC8& aBytes, TInt aErrorCode);

    void OnStartPrefixMappingL(const RString& aPrefix, const RString& aUri, 

        TInt aErrorCode) ;

    void OnEndPrefixMappingL(const RString& aPrefix, TInt aErrorCode);

    void OnIgnorableWhiteSpaceL(const TDesC8& aBytes, TInt aErrorCode);

    void OnSkippedEntityL(const RString& aName, TInt aErrorCode);

    void OnProcessingInstructionL(const TDesC8& aTarget, const TDesC8& aData, 

        TInt aErrorCode);

    void OnError(TInt aErrorCode);

    TAny* GetExtendedInterface(const TInt32 aUid);

private:

    CNcdConfigurationParser( MNcdConfigurationParserObserver& aObserver );                        

    void ConstructL();

private:

    MNcdConfigurationParserObserver& iObserver;

    Xml::CParser* iXmlParser;

    HBufC8* iBuffer;

    };

#endif // C_NCDCONFIGURATIONPARSER_H