// Copyright (c) 1997-2009 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:

 //

 #ifndef __MWAPPLUGINSP_H__

 #define __MWAPPLUGINSP_H__

 // System includes

 //

 #include <e32def.h>

 // Forward class declarations

 //

 class CDocumentNode;

 class CNode;

 class CDTDNode;

 class CXmlElement;

 class CAttributeLookupTable;

 typedef TAny CWmlLibrary;

 //##ModelId=3B666FA402F4

 class MWapPluginSP

 /**

 @publishedAll

 @deprecated

 */

 	{

 public:

 /**

 	Intended Usage	:	Resets the content data pointers in the given document 

 	node and any dependents. This could also reset the data pointer in an 

 	associated data dictionary node and its client document nodes.

 	@since			6.0

 	@param			aDocumentNode	The pointer to the document root node

 	@param			aDataPtr		The pointer to the new data content

 	@pre 			None

 	@post			The data pointers in the specified document node and 

 	dependents have been set to the new data

  */

 	//##ModelId=3B666FA40331

 	virtual void ResetDocumentNodeData(CDocumentNode* aDocumentNode, TAny* aDataPtr) const =0;

 /**

 	Intended Usage	:	Gets hold of the actual node that holds the data for the

 	specified document node. The document data may actually be shared amongst 

 	several document nodes and actually held in the data dictionary.

 	@since			6.0

 	@param			aDocumentNode The pointer to a document node

 	@return			A pointer to node that actual holds the data.

  */

 	//##ModelId=3B666FA4032C

 	virtual CNode& DataStorageNode(const CDocumentNode* aDocumentNode) const =0;

 /**

 	Intended Usage	:	Preload the specified DTD for validating recieved WML 

 	and WMLC decks. The document data handler needs to call this as soon as it

 	knows what type of DTD the document is using. When the document completes,

 	this DTD will be used to validate it before the 100% complete message is 

 	passed up to the engine observer.

 	@since			6.0

 	@param			aDocType		The specified DTD type

 	@param			aDTDURL			The URL of the DTD to be fetched

 	@param			aDocRootNode	The root node of the document to be validated

 	@return			A pointer to the DTD if the specified DTD is available, 

 	otherwise NULL.

 	@todo			Add the pre and post conditions.

 	@pre 			None

 	@post			Unspecified

  */

 	//##ModelId=3B666FA40328

 	virtual const CDTDNode* PrepareDTDL(const TDesC& aDocType, 

 										const TDesC& aDTDURL,

 										const CDocumentNode* aDocRootNode) =0;

 /**

 	Intended Usage	:	Provide a CWmlLibrary object. This object is ready to 

 	process data and build a document tree to the given root node.

 	@since			6.0

 	@warning		The CWmlLibrary object is owned by the WAP Engine.

 	@param			aDocRootNode	A pointer to the root node where the document

 	tree is to be built.

 	@return			A pointer the CWmlLibrary object. 

  */

 	//##ModelId=3B666FA40326

 	virtual CWmlLibrary* WmlLibL(CXmlElement* aDocRootNode) =0;

 /**

 	Intended Usage	:	Gets the Attribute Look Up Table.

 	@since			6.0

 	@return			A reference to the Attribute Look Up Table.

  */

 	//##ModelId=3B666FA4031C

 	virtual CAttributeLookupTable& AttributeLUT() =0;

 	};

 #endif	// __MWAPPLUGINSP_H__