/*

* Copyright (c) 2007-2007 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:  MCFPlugInOperation interface.

*

*/

#ifndef M_CFPLUGINOPERATION_H

#define M_CFPLUGINOPERATION_H

// INCLUDES

#include <e32base.h>

// FORWARD DECLARATIONS

class CCFOperationNode;

class CCFScriptRoot;

class MCFOperationServices;

class CMDXMLNode;

// CLASS DECLARATION

/**

*  This is a plugin operation interface for Script Engine scripts. Parsing

*  operations will be executed via this interface.

*

*  @lib CFScriptEngine

*  @since S60 v5.0

*/

class MCFPlugInOperation

    {

public: // New functions

    /**

    * Parses a xml node and returns a pointer to CCFOperationNode instance.

    * @since S60 5.0

    * @param aParent is the parsed parent node for the aNode.

    * @param aNode is the node to be parsed.

    * @param aOperationServices is the operation services reference to be used

    *   by the new operation node.

    * @param aUid Implementation uid of the provider.

    * @return a ptr to CCFOperationNode instance parsed from the given node,

    *   note that the ownership is transferred to the caller. Returns NULL if

    *   the node cannot be parsed.

    */

    virtual CCFOperationNode* ParseL( CCFOperationNode* aParent,

            CMDXMLNode& aNode,

            MCFOperationServices& aOperationServices,

            TUid& aUid ) = 0;

    /**

    * Parses a xml node and returns a pointer to CCFScriptRoot instance.

    * @since S60 5.0

    * @param aParent is the parsed parent node for the aNode.

    * @param aNode is the node to be parsed.

    * @param aOperationServices is the operation services reference to be used

    *   by the new script root node.

    * @param aUid Implementation uid of the provider.

    * @return a ptr to CCFScriptRoot instance parsed from the given node,

    *   note that the ownership is transferred to the caller. Returns NULL if

    *   the node cannot be parsed.

    */

    virtual CCFScriptRoot* ParseScriptRootL( CCFOperationNode* aParent,

            CMDXMLNode& aNode,

            MCFOperationServices& aOperationServices,

            TUid& aUid ) = 0;

protected: // Destructor

    // Deny destruction through this interface.

    virtual ~MCFPlugInOperation(){};

    };

#endif // M_CFPLUGINOPERATION_H