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