williamr@2: // Copyright (c) 2003-2009 Nokia Corporation and/or its subsidiary(-ies).
williamr@2: // All rights reserved.
williamr@2: // This component and the accompanying materials are made available
williamr@2: // under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members
williamr@2: // which accompanies this distribution, and is available
williamr@2: // at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
williamr@2: //
williamr@2: // Initial Contributors:
williamr@2: // Nokia Corporation - initial contribution.
williamr@2: //
williamr@2: // Contributors:
williamr@2: //
williamr@2: // Description:
williamr@2: // This file contains the declaration of the generic CMDXMLParser class
williamr@2: // which is responsible for creating a DOM structure
williamr@2: // from a given XML file.
williamr@2: // 
williamr@2: //
williamr@2: 
williamr@2: 
williamr@2: 
williamr@2: /**
williamr@2:  @file
williamr@2: */
williamr@2: 
williamr@2: #ifndef __GMXMLPARSER_H__
williamr@2: #define __GMXMLPARSER_H__
williamr@2: 
williamr@2: #include <e32std.h>
williamr@2: #include <eikenv.h>
williamr@2: #include <gmxmlconstants.h>
williamr@2: 
williamr@2: //forward reference
williamr@2: class CMDXMLDocument;
williamr@2: class CMDXMLEntityConverter;
williamr@2: class CMDXMLElement;
williamr@2: class MXMLDtd;
williamr@2: 
williamr@2: 
williamr@2: 
williamr@2: class MMDXMLParserObserver
williamr@2: /** Abstract observer interface for notification when XML parsing is complete.
williamr@2: 
williamr@2: It should be implemented by users of CMDXMLParser
williamr@2: @publishedAll 
williamr@2: @released*/
williamr@2: 	{
williamr@2: public:
williamr@2: 	/**
williamr@2: 	Call back function used to inform a client of the Parser when a parsing operation completes.
williamr@2: 	 */
williamr@2: 	virtual void ParseFileCompleteL() = 0;
williamr@2: 	};
williamr@2: 
williamr@2: class MMDXMLParserDataProvider
williamr@2: /** Abstract data source interface for XML data source.
williamr@2: 
williamr@2: The user of CMDXMLParser must build one of these to encapsulate the data source
williamr@2: that they wish to parse.  CMDXMLParser implements a file-based data source to
williamr@2: implement the functionality of the ParseFile function.
williamr@2: 
williamr@2: @publishedAll 
williamr@2: @released*/
williamr@2: 	{
williamr@2: public:
williamr@2: 	/** Status codes returned by GetData() implementations. */
williamr@2: 	enum TDataProviderResults
williamr@2: 		{
williamr@2: 		KMoreData,		///< Returned by the interface implementation when it is returning more data.
williamr@2: 		KDataStreamError,	///< Returned by the interface when an unrecoverable error prevents obtaining more data.  A recoverable error should be represented by KDataNotReady.
williamr@2: 		KDataStreamEnd	///< Returned by the interface when there is no more data to come.
williamr@2: 		};
williamr@2: 
williamr@2: public:
williamr@2: 	/** 
williamr@2: 	The XML Parser calls this on a specific data provider to get more data
williamr@2: 	when required.
williamr@2: 
williamr@2: 	Note that the TPtrC supplied may be used by the parser at any time
williamr@2: 	between the return of this call and the next call that the parser
williamr@2: 	makes out.
williamr@2: 
williamr@2: 	Your data provider must not move the data pointed to until the
williamr@2: 	parser has indicated that it's done with that block by asking for
williamr@2: 	another.
williamr@2: 
williamr@2: 	Ownership of the data pointed to remains with the data provider.
williamr@2: 
williamr@2: 
williamr@2: 	General comments on efficiency
williamr@2: 	------------------------------
williamr@2: 
williamr@2: 	The parser is designed such that it processes the whole data block
williamr@2: 	provided in one go.  It will automatically become asynchronous when
williamr@2: 	another block is required - the data provider only needs to supply
williamr@2: 	data.
williamr@2: 
williamr@2: 	Because of this design, it allows the data provider to indirectly
williamr@2: 	control the amount of processing time that will be needed
williamr@2: 	in a single block.
williamr@2: 
williamr@2: 	It is a good idea to balance the need for the fastest possible 
williamr@2: 	processing with the need for client application responsiveness by
williamr@2: 	ensuring that the amount of data passed in a single block is not 
williamr@2: 	too large.	However, it is worth bearing in mind that the parser
williamr@2: 	will convert UTF8 data streams in blocks of 32 characters, and
williamr@2: 	supplying blocks of smaller length than this will result in a
williamr@2: 	slight loss of efficiency.
williamr@2: 
williamr@2: 	@param aPtr On return, the data provided
williamr@2: 	@param aStatus Asynchronous status to be completed by the function with a 
williamr@2: 	TDataProviderResults value
williamr@2: 	*/
williamr@2: 	virtual void GetData(TPtrC8 &aPtr, TRequestStatus &aStatus) = 0;
williamr@2: 	/**
williamr@2: 	Called to indicate that use of the data source is complete.
williamr@2: 	*/
williamr@2: 	virtual void Disconnect() = 0;
williamr@2: 	};
williamr@2: 
williamr@2: class CMDXMLParserFileDataSource;
williamr@2: 
williamr@2: class CMDXMLParser: public CActive
williamr@2: /** Creates a DOM structure from a given XML file.
williamr@2: 
williamr@2: The parsing operation is asynchronous and is initiated by a call to ParseFile(). 
williamr@2: On completion, the created DOM document can be retrieved through DetachXMLDoc().
williamr@2: 
williamr@2: Note the following ownership rules for the DOM document:
williamr@2: 
williamr@2: 1. calling DetachXMLDoc() transfers ownership of the document to the client
williamr@2: 
williamr@2: 2. if the parser is asked to parse a new file while it still owns an existing 
williamr@2: DOM document, it will delete the old document.
williamr@2: 
williamr@2: @publishedAll
williamr@2: @released
williamr@2: */
williamr@2: 	{
williamr@2: public:
williamr@2: 	/** Allocates and constructs a new XML parser, specifying a DTD.
williamr@2: 	
williamr@2: 	@param aParserObserver XML parser observer
williamr@2: 	@leave KErrNoMemory Out of memory
williamr@2: 	@return New XML parser */
williamr@2: 	IMPORT_C static CMDXMLParser* NewL(MMDXMLParserObserver* aParserObserver);
williamr@2: 
williamr@2: 	/** Allocates and constructs a new XML parser, specifying a DTD.
williamr@2: 	
williamr@2: 	@param aParserObserver XML parser observer
williamr@2: 	@param aDtdRepresentation DTD validator
williamr@2: 	@leave KErrNoMemory Out of memory
williamr@2: 	@return New XML parser */
williamr@2: 	IMPORT_C static CMDXMLParser* NewL(MMDXMLParserObserver* aParserObserver, MXMLDtd* aDtdRepresentation);
williamr@2: 
williamr@2: 	/** Allocates and constructs a new XML parser, leaving the object on the cleanup 
williamr@2: 	stack.
williamr@2: 	
williamr@2: 	@param aParserObserver XML parser observer
williamr@2: 	@leave KErrNoMemory Out of memory
williamr@2: 	@return New XML parser */
williamr@2: 	IMPORT_C static CMDXMLParser* NewLC(MMDXMLParserObserver* aParserObserver);
williamr@2: 
williamr@2: 	/** Allocates and constructs a new XML parser, leaving the object on the cleanup 
williamr@2: 	stack.
williamr@2: 	
williamr@2: 	@param aParserObserver XML parser observer
williamr@2: 	@param aDtdRepresentation DTD validator
williamr@2: 	@leave KErrNoMemory Out of memory
williamr@2: 	@return New XML parser */
williamr@2: 	IMPORT_C static CMDXMLParser* NewLC(MMDXMLParserObserver* aParserObserver, MXMLDtd* aDtdRepresentation);
williamr@2: 
williamr@2: 
williamr@2: 	/** Destructor. */
williamr@2: 	IMPORT_C ~CMDXMLParser();
williamr@2: 
williamr@2: 	/** Gets the last error found by the parser.
williamr@2: 	
williamr@2: 	@return Error code
williamr@2: 	 */
williamr@2: 	IMPORT_C TInt Error() const;
williamr@2: 
williamr@2: 	/**
williamr@2: 	 Get the severity of the most severe error found.
williamr@2: 	 @return the maximum error severity
williamr@2: 	 */
williamr@2: 	IMPORT_C TXMLErrorCodeSeverity ErrorSeverity() const; 
williamr@2: 
williamr@2: 	/** Gets the created DOM.
williamr@2: 	
williamr@2: 	This should be called after the conclusion of the parser process.
williamr@2: 	
williamr@2: 	Note that the function sets the internal variable pointing to the document 
williamr@2: 	to NULL, so this function can only be called once per file parse. The caller 
williamr@2: 	takes ownership of the document, and must delete it when its use is complete.
williamr@2: 	
williamr@2: 	@return The created DOM */
williamr@2: 	IMPORT_C CMDXMLDocument* DetachXMLDoc();
williamr@2: 
williamr@2: 	/** Parses a specified XML file into a DOM object tree.
williamr@2: 	
williamr@2: 	@param aRFs File server session
williamr@2: 	@param aFileToParse The file name to parse
williamr@2: 	@return KErrNone if success or a file read error code */
williamr@2: 	IMPORT_C TInt ParseFile(RFs aRFs, const TDesC& aFileToParse);
williamr@2: 	
williamr@2: 	IMPORT_C TInt ParseFile(RFile& aFileHandleToParse);
williamr@2: 
williamr@2: 	/** Parses a specified XML Data Source into a DOM object tree.
williamr@2: 	Use ParseSourceL() function in preference to ParseSource()
williamr@2: 	@param aSource MMDXMLParserDataProvider pointer 
williamr@2: 	*/
williamr@2: 	inline void ParseSource(MMDXMLParserDataProvider *aSource)
williamr@2: 		{
williamr@2: 		TRAP_IGNORE(ParseSourceL(aSource));
williamr@2: 		} 
williamr@2: 				
williamr@2: 	/** Parses a specified XML Data Source into a DOM object tree.	
williamr@2: 	@param aSource MMDXMLParserDataProvider pointer 
williamr@2: 	*/
williamr@2: 	IMPORT_C void ParseSourceL(MMDXMLParserDataProvider *aSource);
williamr@2: 
williamr@2: 	/** Defines input stream character widths. */
williamr@2: 	enum TMDXMLParserInputCharWidth
williamr@2: 		{
williamr@2: 		EAscii = 0x01, ///< ASCII
williamr@2: 		EUnicode = 0x02 ///<Unicode
williamr@2: 		};
williamr@2: 	
williamr@2: 	/** Sets the input stream character width.
williamr@2: 	 *
williamr@2: 	 * @param aWidth Character width for incoming stream.  Possible values are EAscii and EUnicode (representing Ascii/UTF8 and Unicode respectively).
williamr@2: 	 *
williamr@2: 	 */
williamr@2: 	IMPORT_C void SetSourceCharacterWidth(TMDXMLParserInputCharWidth aWidth);
williamr@2: 
williamr@2: 	//Defect fix for INC036136- Enable the use of custom entity converters in GMXML
williamr@2: 	/**
williamr@2: 	 * Sets the entity converter to be used for parsing.
williamr@2: 	 * and  take ownership of the passed entity converter
williamr@2: 	 * @param aEntityConverter the entity converter to be used.
williamr@2: 	 */
williamr@2: 	IMPORT_C void SetEntityConverter(CMDXMLEntityConverter* aEntityConverter);
williamr@2: 	//End Defect fix for INC036136
williamr@2: 
williamr@2: 	/**
williamr@2: 	 Controls whether invalid elements and attributes are added to the DOM.
williamr@2: 	 @param aStoreInvalid ETrue if invalid content should be stored, EFalse otherwise.
williamr@2: 	 */
williamr@2: 	IMPORT_C void SetStoreInvalid(TBool aStoreInvalid);
williamr@2: 	
williamr@2: 	/**
williamr@2: 	 Controls whether whitespaces are handled by XML parser or by client.
williamr@2: 	 @param aPreserve ETrue if all whitespaces should be preserved (handled by client), EFalse otherwise.
williamr@2: 	 */
williamr@2: 	IMPORT_C void SetWhiteSpaceHandlingMode(TBool aPreserve);
williamr@2: 
williamr@2: public: // public functions used by other classes within the .dll, not for Export.
williamr@2: 	/** Gets the entity converter.
williamr@2: 	
williamr@2: 	@return The entity converter */
williamr@2: 	CMDXMLEntityConverter* EntityConverter();
williamr@2: 
williamr@2: private:
williamr@2: 	IMPORT_C virtual void DoCancel();
williamr@2: 
williamr@2: 	/*
williamr@2: 	 * RunL function inherited from CActive base class - carries out the actual parsing.
williamr@2: 	 * @leave can Leave due to OOM
williamr@2: 	 */
williamr@2: 	virtual void RunL();
williamr@2: 
williamr@2: 	/*
williamr@2: 	 * Helper function that does the parsing - called from inside RunL
williamr@2: 	 */
williamr@2: 	TBool DoParseLoopL();
williamr@2: 
williamr@2: 	/*
williamr@2: 	 * RunError function inherited from CActive base class - intercepts any Leave from
williamr@2: 	 * the RunL() function, sets an appropriate errorcode and calls ParseFileCompleteL
williamr@2: 	 */
williamr@2: 	IMPORT_C TInt RunError(TInt aError);
williamr@2: 
williamr@2: 	/*
williamr@2: 	 * Constructors
williamr@2: 	 */
williamr@2: 	CMDXMLParser(MMDXMLParserObserver* aParserObserver);
williamr@2: 
williamr@2: 	CMDXMLParser(MMDXMLParserObserver* aParserObserver, MXMLDtd* aDtdRepresentation);
williamr@2: 
williamr@2: 	/*
williamr@2: 	 * Called when a character is read in and found to bo outside of an element tag
williamr@2: 	 */
williamr@2: 	virtual void HandleTextL(TDes& aChar);
williamr@2: 
williamr@2: 	enum TGetCharReturn
williamr@2: 		{
williamr@2: 		KError = 0x00,			// GetChar detected an error
williamr@2: 		KCharReturned,	// GetChar returned a character
williamr@2: 		KWaitForChar	// GetChar couldn't return a character this time, but might next time.
williamr@2: 		};
williamr@2: 
williamr@2: 	/*
williamr@2: 	 * Fetch one character from the input file
williamr@2: 	 * @param aChar the returned character.
williamr@2: 	 * @return returns one of the values of TCharReturn
williamr@2: 	 */
williamr@2: 	TGetCharReturn GetChar(TDes& aChar);
williamr@2: 
williamr@2: 	/* utility functions, called from GetChar to deal with the
williamr@2: 	 * 2 types of input stream
williamr@2: 	 */
williamr@2: 	TGetCharReturn GetDoubleByteChar(TDes& aChar);
williamr@2: 	TGetCharReturn GetSingleByteChar(TDes& aChar);
williamr@2: 
williamr@2: 	/*
williamr@2: 	 * Fetch some more data from the data provider
williamr@2: 	 * @return returns one of the values of TCharReturn
williamr@2: 	 */
williamr@2: 	void GetMoreData();
williamr@2: 
williamr@2: 	/*
williamr@2: 	 * @return Returns true if the current tag is a doctype tag and sets the
williamr@2: 	 * Document DocType member accordingly on the first pass of this function.
williamr@2: 	 */
williamr@2: 	TBool DocTypeL();
williamr@2: 
williamr@2: 	/*
williamr@2: 	 * creates a new processing instruction if necessary and adds to document
williamr@2: 	 * @return Returns true if the current tag is a processing instruction
williamr@2: 	 */
williamr@2: 	TBool ProcessingInstructionL(CMDXMLElement* aParentElement);
williamr@2: 
williamr@2: 	/*
williamr@2: 	 * creates a new CDataSection if necessary and adds to document
williamr@2: 	 * @return Returns true if the current tag is a processing instruction
williamr@2: 	 */
williamr@2: 	TBool CDataSectionL(CMDXMLElement* aParentElement);
williamr@2: 	TBool EndOfCDataSection();
williamr@2: 
williamr@2: 	/*
williamr@2: 	 * @return returns true if the current tag is a version id tag and sets the
williamr@2: 	 * Document Version member accordingly on the first pass of this function.
williamr@2: 	 */
williamr@2: 	TBool VersionIDL();
williamr@2: 
williamr@2: 	/*
williamr@2: 	 * creates a new comment if necessary and adds to document
williamr@2: 	 * @return returns true if the current tag is a comment tag
williamr@2: 	 */
williamr@2: 	TBool CommentL(CMDXMLElement* aParentElement);
williamr@2: 
williamr@2: 	/*
williamr@2: 	 * Parse a start of element tag and create an element with attributes set.
williamr@2: 	 * @return Returns a pointer to the created element
williamr@2: 	 * @leave can Leave due to OOM
williamr@2: 	 */
williamr@2: 	virtual CMDXMLElement* ParseStartTagL();
williamr@2: 
williamr@2: 	/*
williamr@2: 	 * Detects the type of a file - can be Unicode or UTF-8
williamr@2: 	 */
williamr@2: 	TBool DetectFileType();
williamr@2: 
williamr@2: 	/*
williamr@2: 	 * Creates a generic or DTD-specific document object
williamr@2: 	 * @leave can Leave due to OOM
williamr@2: 	 */
williamr@2: 	virtual void CreateDocumentL();
williamr@2: 
williamr@2: 	/*
williamr@2: 	 * Sets iError to new errorcode if more serious than any error so far encountered
williamr@2: 	 */
williamr@2: 	IMPORT_C void SetError(const TInt aErrorCode, const TXMLErrorCodeSeverity aSeverity);
williamr@2: 
williamr@2: 	/*
williamr@2: 	 * This function is used to parse the attributes.
williamr@2:      * @param aElement The element to which the attributes belong
williamr@2:      * @param aTagToParse The tag to be parsed
williamr@2:      * @return Returns KErrNone if both attribute name & value are valid 
williamr@2: 	 * KErrXMLBadAttributeName if attribute name is invalid or KErrXMLBadAttributeValue is invalid
williamr@2:      * @leave can Leave due to OOM
williamr@2: 	 */
williamr@2: 	TInt ParseElementAttributesL(CMDXMLElement& aElement, TDes& aTagToParse);
williamr@2: 
williamr@2: 	/** 
williamr@2: 	  This function locates the next attribute in the tag.
williamr@2: 	  @param aTagToParse the tag to find the attribute in
williamr@2: 	  @return the offset of the next attribute
williamr@2: 	 */
williamr@2: 	TInt LocateNextAttribute(const TDesC& aTagToParse);
williamr@2: 
williamr@2:     /*
williamr@2:      * Parses an end tag.  In fact, at this point the end tag must match
williamr@2:      * the tag name of the start tag.  
williamr@2:      * @param aTagToParse Text of the end tag.
williamr@2:      * @return Returns KErrNone if the end tag matches the start tag or KErrNotFound if there is a mismatch.
williamr@2:      */
williamr@2: 	TInt ParseElementEndTag(CMDXMLElement& aElement, const TDesC& aTagToParse);
williamr@2: 
williamr@2: 	TInt CheckForStartCData(const TDesC& aTextToCheck);
williamr@2: 	TInt FindDelimiter(TDesC& aDataToSearch, TDesC& aDelimiterToFind);
williamr@2: 
williamr@2: 	/*
williamr@2: 	 * Second stage constructor
williamr@2: 	 */
williamr@2: 	void ConstructL(MXMLDtd* aDtdRepresentation);
williamr@2: 	void AddTextL(CMDXMLElement* aParentElement);
williamr@2: 
williamr@2: 	/*
williamr@2: 	 * Checks whether the end of this tag is in a CDataSection.
williamr@2: 	 * @param aDataToSearch The data to check
williamr@2: 	 * @return Returns ETrue if the tag contains an unclosed CDataSection
williamr@2: 	 */
williamr@2: 	TBool InCDataSection(TDesC& aDataToSearch);
williamr@2: 
williamr@2: 	/*
williamr@2: 	 * Entity converts the sections of one attribute value that are not within a CDataSection.
williamr@2: 	 * @param aAttributeValue one attribute value
williamr@2: 	 * @return Returns an error if entity conversion did not successfully complete, otherwise KErrNone
williamr@2: 	 */
williamr@2: 	TInt ParseSingleAttributeL(TDes& aAttributeValue);
williamr@2: 
williamr@2: 	/*
williamr@2: 	 * Prepares this class for use on another file.
williamr@2: 	 *
williamr@2: 	 */
williamr@2: 	void PrepareForReuseL();
williamr@2: 
williamr@2: 	/**
williamr@2: 	 This should be called when parsing has been completed, before calling ParseFileCompleteL().
williamr@2: 	 It checks for errors that can only be determined at the end of parsing, eg missing doctype or 
williamr@2: 	 incomplete content.
williamr@2: 	 */
williamr@2: 	void CheckForErrors();
williamr@2: 
williamr@2: 	IMPORT_C void PlaceholderForRemovedExport1(MMDXMLParserObserver* aParserObserver);
williamr@2: 	IMPORT_C void PlaceholderForRemovedExport2(MMDXMLParserObserver* aParserObserver, MXMLDtd* aDtdRepresentation);
williamr@2: 	IMPORT_C void PlaceholderForRemovedExport3();
williamr@2: 
williamr@2: 
williamr@2: private:
williamr@2: 	enum TPanicCode {	ENullMemVarDataSource, 
williamr@2: 						ENullMemVarParserObserver, 
williamr@2: 						ENullMemVarXMLDoc, 
williamr@2: 						ENullMemVarElementTag, 
williamr@2: 						ENullParameterParentElement };
williamr@2: 	void Panic(TPanicCode aReason) const;
williamr@2: 
williamr@2: private:
williamr@2: 	MMDXMLParserObserver* iParserObserver;
williamr@2: 	MXMLDtd* iDtdRepresentation;
williamr@2: 	TInt iError;								// Current error
williamr@2: 	TXMLErrorCodeSeverity iSeverity;			// ErrorCode severity
williamr@2: 	CMDXMLDocument* iXMLDoc;					// Document created by the parser
williamr@2: 	CMDXMLEntityConverter* iEntityConverter;	// Entity converter used by the parser
williamr@2: 	HBufC* iElementTag;							// Currently processed element tag
williamr@2: 	TBool iDocTypeSet;
williamr@2: 	TBool iVersionSet;
williamr@2: 	TInt iBytesPerChar;
williamr@2: 
williamr@2: 	/* member variables dealing with access to source data */
williamr@2: 	TPtrC8 iInputBufferPtr;						// set during a call to get more data
williamr@2: 	TInt iCurrentInputBufferLen;				// current length of the data block available
williamr@2: 	TInt iNextChar;								// read position in the data block
williamr@2: 	TInt iInputBytesRemaining;					// number of bytes remaining to read.
williamr@2: 	HBufC8 *iUTF8EdgeBuffer;					// buffer to hold up to 6 bytes so that UTF8 parsing can span edges of data blocks
williamr@2: 	HBufC8 *iBomBuffer;							// buffer to hold data at the start of the stream so we may determine charset
williamr@2: 	TInt iRequiredUTF8Bytes;					// number of bytes required to complete the character held in the edge buffer
williamr@2: 	TBool iUnicodeInputMisaligned;				// Set to ETrue if the unicode input stream is not aligned to 16-bit boundaries
williamr@2: 	MMDXMLParserDataProvider* iDataSource;		// XML Data Source being parsed.
williamr@2: 	CMDXMLParserFileDataSource* iFileSource;	// We own this, and need to free it when we are done. Only used when we're providing the data source object to wrap a local file.
williamr@2: 
williamr@2: 	/* member variables dealing with chunked conversion into unicode output */
williamr@2: 	TBuf<32> iUnicodeConversion;				// buffer to temporarily hold the results of conversion from UTF8 to Unicode
williamr@2: 	TInt iUnicodeConversionLen;					// number of characters stored in our intermediate buffer
williamr@2: 	TInt iUnicodeReadPos;						// next character to send from our intermediate buffer
williamr@2: 	TBuf<1> iSpareChar;
williamr@2: 
williamr@2: 	/* member variables used when parsing a local file */
williamr@2: 	TDesC *iFileToParse;
williamr@2: 	RFs iRFs;
williamr@2: 	RFile iFileHandleToParse;
williamr@2: 
williamr@2: 	TBool iEndOfTag;
williamr@2: 	
williamr@2: 	/* member variables used in DoParseLoopL() */
williamr@2: 	TBool iOpened;
williamr@2: 	TBool iClosed;
williamr@2: 	CMDXMLElement* iNewElement;
williamr@2: 	CMDXMLElement* iParentElement;
williamr@2: 	HBufC* iText;
williamr@2: 	enum EParserStates
williamr@2: 		{
williamr@2: 		KInitFromFile,
williamr@2: 		KDetermineCharset,
williamr@2: 		KWaitingForData,
williamr@2: 		KParseData,
williamr@2: 		KSpanDataGap,
williamr@2: 		KFinished
williamr@2: 		};
williamr@2: 
williamr@2: 	EParserStates iState;
williamr@2: 	EParserStates iPreviousState;
williamr@2: 	TInt iSuspiciousCharacter;
williamr@2: 	TBool iStoreInvalid;						// controls whether invalid elements and attributes are stored in the DOM.
williamr@2: 	TBool iPreserve;
williamr@2: 
williamr@2: 	};
williamr@2: 
williamr@2: #endif