/*
* Copyright (c) 2007-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:  CFContextSourceManager class declaration.
*
*/



#ifndef C_CFOPERATIONPLUGINMANAGER_H
#define C_CFOPERATIONPLUGINMANAGER_H

#include "cfecompluginmanager.h"
#include "cfpluginoperation.h"
#include "cfstarterobserver.h"
#include "cfoperationplugin.h"
#include "cfstateobserver.h"

class CCFOperationPlugIn;
class MCFOperationServices;
class TCFOperationPluginInfo;
class CImplementationInformation;
class MCFScriptEngineInterface;

/**
 *  Operation plug-in manager.
 *
 *  Operation plug-in manager is responsible for loading all the
 *  operation plug-ins that are currently installed.
 *
 *  @lib cfscriptengine.lib
 *  @since S60 4.0
 */
NONSHARABLE_CLASS( CCFOperationPluginManager ) : public CCFEComPluginManager,
    public MCFPlugInOperation,
    public MCFStarterObserver,
    public MCFStateObserver
    {
    public:

        // Two phased constrcutors
        IMPORT_C static CCFOperationPluginManager* NewL(
            MCFScriptEngineInterface& aScriptEngine );
        IMPORT_C static CCFOperationPluginManager* NewLC(
            MCFScriptEngineInterface& aScriptEngine );

        // Destructor
        IMPORT_C virtual ~CCFOperationPluginManager();

    public: // From MCFPlugInOperation

        /**
        * 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.
        */
        CCFScriptRoot* ParseScriptRootL( CCFOperationNode* aParent,
                CMDXMLNode& aNode,
                MCFOperationServices& aOperationServices,
                TUid& aUid );

        /**
        * Parse DOM-node into an operation node.
        *
        * @since S60 5.0
        * @param aParent Parent node.
        * @param aDOMNode DOM-node to be parsed.
        * @param aOperationServices Operation services instance to be used
        *   by the new operation node.
        * @param aUid Implementation uid of the provider.
        * @return Pointer to Operation node. The ownership of the node is
        *   transferred to the caller. NULL must be returned, if the DOM-node
        *   cannot be parsed.
        */
        CCFOperationNode* ParseL( CCFOperationNode* aParent,
            CMDXMLNode& aDOMNode,
            MCFOperationServices& aOperationServices,
            TUid& aUid );

    public: // From base classes

        // from MCFStateObserver
        void UpdatePlugInsL();

    private: // From base classes

        // @see MCFInitialize
        void InitializePhaseL( CCFPhaseBase::TCFPhaseId aPhase );
        
        // @see MCFStarterObserver
        void SetEventHandler( MCFStarterEventHandler& /*aEventHandler*/ );

    private:

        CCFOperationPluginManager( MCFScriptEngineInterface& aScriptEngine );
        void ConstructL();

    private: // New methods

        // Loads and initialized plug-in
    	CCFOperationPlugIn* CreateAndInitializePlugInL(
            const TUid& aImplementationUid,
            TOperationPluginInitParams& aParams );

        // Init starting phase
        void InitDeviceStartingPhaseL();

        // Init loading plugins phase
        void InitLoadingPluginsPhaseL();

        // Loads plug-ins and appends it into array
        void LoadPluginL( CImplementationInformation& aImplInfo );

        // Releases operation plug-in
        void ReleasePlugIn( CCFOperationPlugIn*& aPlugIn );

        // Finalizes node parsing
        CCFOperationNode* DoParseL( CCFOperationNode* aParent,
            CMDXMLNode& aDOMNode,
            MCFOperationServices& aOperationServices,
            TUid& aUid );

        // Finalizes script root parsing
        CCFScriptRoot* DoParseScriptRootL( CCFOperationNode* aParent,
            CMDXMLNode& aDOMNode,
            MCFOperationServices& aOperationServices,
            TUid& aUid );

    private: // data

        // Own: Context source plugin info array
        RArray<TCFOperationPluginInfo> iPlugIns;

        // Ref: Reference to script engine
        MCFScriptEngineInterface& iScriptEngine;
    };

#endif