/*

* Copyright (c) 2008 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:

*

*/

/** @file

@publishedAll

@released

*/

#ifndef XMLENGDOMIMPLEMENTATION_H

#define XMLENGDOMIMPLEMENTATION_H

#include <e32base.h>

/**

The RXmlEngDOMImplementation interface provides a number of methods for performing 

operations that are independent of any particular instance of the document object model. 

http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407/core.html#ID-102161490

*/

class RXmlEngDOMImplementation

{

  public:

	/**

	Open method needed to initialize the DOM library and should be called

	before using any class/function from this library.  The initialization is

	required in every client thread in which it used. Calling this method

	multiple times in a thread is allowed. There should be a call to Close()

	for every call to Open, per thread.

	@param aHeap This argument not used at present and is ignored in the

	implementation.

	@leave - One of the system-wide error codes

    */

    IMPORT_C void OpenL( RHeap* aHeap = NULL );

	/**

	Close method. It cleans up resources used by the DOM library. Clients

	should call this method at the end of library usage. The library should not

	be used after this call. If needed, clients can initialize the library

	again by calling the Open() method. 

    @param aReserved This parameter is not used

    */

    IMPORT_C void Close(TBool aReserved);

	/**

	Close method. It cleans up resources used by the DOM library. Clients

	should call this method at the end of library usage. The library should not

	be used after this call. If needed, clients can initialize the library

	again by calling the Open() method. 

	*/	

    IMPORT_C void Close();

};

#endif /* XMLENGDOMIMPLEMENTATION_H */