/*
* 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:  
*
*/

#ifndef LAUNCHERXMLPARSER_H_
#define LAUNCHERXMLPARSER_H_

#include <e32base.h>
#include <xml/contenthandler.h>
#include <xml/parser.h>
#include "launcherdllelement.h"
#include "launcherparserobserver.h"

using namespace Xml;

const TUint KXMLBufferSize = 1024;

class CLauncherDLLElement;

/**
 * Parses DLL data from the given XML-file
 */
class CLauncherXMLParser : public CActive, public MContentHandler
{
public:

    virtual ~CLauncherXMLParser();
    static CLauncherXMLParser* NewL(RFs& aFs);
    static CLauncherXMLParser* NewLC(RFs& aFs);
    
    /**
     * Parses the given XML-file and notifies the observer.
     * @param aFilePath XML-file's path
     * @param aObserver Pointer to the observer instance.
     */
    void ParseL(const TDesC& aFilePath, MLauncherParserObserver* aObserver);
        
protected:
    
    // from CActive    
    void DoCancel();    
    void RunL();
    
private:

    CLauncherXMLParser(RFs& aFs);
    void ConstructL();
    
    /**
     * Tells whether the current XML element is a sub-element of the 'dll'-element.
     * @return ETrue if the current XML-element is sub-element of the 'dll'-element.
     */
    TBool IsDataElement();

    /**
     * Deletes current data buffer and zeroes the pointer.
     */
    void ClearXMLDataBuffer();
    
    /**
     * Converts 8-bit descriptor to 32-bit unsigned integer
     * @return Converted 32-bit unsigned integer value.
     * @param aStr 8-bit descriptor to be converted.
     */
    TUint32 ConvertDes8ToUint32L(const TDesC8& aStr);
                
public:
    // From MContentHandler:    
    void OnStartDocumentL(const RDocumentParameters &aDocParam, TInt aErrorCode);
    void OnEndDocumentL(TInt aErrorCode);
    void OnStartElementL(   const RTagInfo& aElement, 
                            const RAttributeArray& aAttributes, 
                            TInt aErrorCode);
    void OnEndElementL(const 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:
    CParser* iParser;  // XML parser
    RFs& iFileSession;
    RFile iFile; // XML file 
    TBuf8<KXMLBufferSize> iXMLDataBuffer;
    MLauncherParserObserver* iObserver;
    CLauncherDLLElement* iCurrentDllElement;
    TBuf8<KMaxFileName> iCurrentContent;
    TBuf8<KMaxName> iCurrentElementName;
    TBool iIgnoreError;
    TInt  iParsedBytes;
};

#endif /* LAUNCHERXMLPARSER_H_ */