/*

* Copyright (c) 2002-2005 Nokia Corporation and/or its subsidiary(-ies). 

* All rights reserved.

* This component and the accompanying materials are made available

* 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

* which accompanies this distribution, and is available

* at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".

*

* Initial Contributors:

* Nokia Corporation - initial contribution.

*

* Contributors:

*

* Description:        This is an abstract interface enabling factory pattern

*

*/

#ifndef SEN_PARSER_H

#define SEN_PARSER_H

#include <Xml/ContentHandler.h>

#include <Xml/Parser.h>

using namespace Xml;

// FORWARD DECLARATIONS

class CSenContentHandler;

class CSenFragmentBase;

class CSenParser : public CBase

    {

    public: // Constructors and destructor

        /**

         *  Standard 2 phase constructor.

         *  @since Series60 4.0

         */

        IMPORT_C static CSenParser* NewL();

        /**

         *  Standard 2 phase constructor.

         *  @since Series60 4.0

         */       

        IMPORT_C static CSenParser* NewLC();

        /**

         *  Standard 2 phase constructor.

         *  @param aParser : where construction 

         *                  data will be copied from.         

         *  @since Series60 4.0

         */

        IMPORT_C static CSenParser* NewL(CParser* aParser);

        /**

         *  Standard 2 phase constructor.

         *  @param aParser : where construction 

         *                  data will be copied from.         

         *  @since Series60 4.0

         */        

        IMPORT_C static CSenParser* NewLC(CParser* aParser);

        /**

         *  Standard 2 phase constructor.

         *  @param aParserMimeType : where construction 

         *                  data will be copied from.         

         *  @since Series60 4.0

         */

        IMPORT_C static CSenParser* NewL(const TDesC8& aParserMimeType);

        /**

         *  Standard 2 phase constructor.

         *  @param aParserMimeType : where construction 

         *                  data will be copied from.         

         *  @since Series60 4.0

         */        

        IMPORT_C static CSenParser* NewLC(const TDesC8& aParserMimeType);

		/**

		 * Sets the ContentHandler

		 * @param aContentHandler

		 */	

        virtual void SetContentHandler(CSenFragmentBase& aContentHandler) = 0;

		/**

		 * Parsing Begins

		 */

        virtual void ParseBeginL() = 0;

        /**

         * Parsing Begins

         * @param aDocumentMimeType This contains the Mime Type

         */

        virtual void ParseBeginL(const TDesC8& aDocumentMimeType) = 0;

		/**

		 * Parsing

		 * @param aFragment

		 * @param aContentHandler

		 */

        virtual void ParseL(const TDesC8& aFragment,

                                CSenFragmentBase& aContentHandler) = 0;

		/**

		 * Parsing

		 * @param aFs

		 * @param aFilename

		 * @param aContentHandler

		 */                                

        virtual void ParseL(RFs& aFs, const TDesC& aFilename,

                                 CSenFragmentBase& aContentHandler) = 0;

		/**

		 * Parsing

		 * @param aFs

		 * @param aContentHandler

		 */                                                                 

        virtual void ParseL(RFile& aFile, CSenFragmentBase& aContentHandler) = 0;

        /**

         * Parsing Ends

         */

        virtual void ParseEndL() = 0;

		/**

		 * Sets the Processor Chain

		 */

        virtual void SetProcessorChainL(const RContentProcessorUids& aPlugins) = 0;

		/**

		 * Enables the Parsing Feature 

		 */

        virtual TInt EnableFeature(TInt aParserFeature) = 0;

   		/**

		 * Disables the Parsing Feature 

		 */

        virtual TInt DisableFeature(TInt aParserFeature) = 0;

        /**

         * @param aParserFeature

         * @return True if parser feature is enabled

         *		   False if parser feature is disabled

         */

        virtual TBool IsFeatureEnabled(TInt aParserFeature) const = 0;

		/**

		 * 

		 */

        virtual void AddPreloadedDictionaryL(const TDesC8& aPublicId) = 0;

		/**

		 * 

		 */

        virtual RStringPool& StringPool() = 0;

        /**

         * 

         */

        virtual RStringDictionaryCollection& StringDictionaryCollection() = 0;

    protected:

        CSenParser();

    };

#endif //SEN_PARSER_H

// End of File