/*
* Copyright (c) 2005 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:  Resolves and loads ECom plugins into new threads.
*
*/

#ifndef MEDIATORSERVERPLUGINHANDLER_H
#define MEDIATORSERVERPLUGINHANDLER_H

// INCLUDES
#include <e32base.h>
#include <ecom/ecom.h>

// CLASS DECLARATION

/**
*  Plugin handler class for Mediator Server.
*
*  @lib MediatorServer
*  @since S60 3.1
*/
class CMediatorServerPluginHandler : public CBase
    {
    public:  // Constructors and destructor
        
        /**
        * Two-phased constructor.
        */
        static CMediatorServerPluginHandler* NewL();
        
        /**
        * Destructor.
        */
        virtual ~CMediatorServerPluginHandler();

    public: // New functions
        
        /**
        * Thread's entry point
        * @since S60 3.1
        * @param aParameter Pointer of parameter passed to thread
        * @return Error code of thread creating
        *         KErrNone if succesfully
        */
        static TInt ThreadEntryPoint( TAny* aParameter );

        /**
        * Starts the thread creating
        * @since S60 3.1
        * @param aMediatorPluginUid Implementation uid for Mediator plugin
        * @param aThreadName Thread name
        * @return None.
        */
        void StartThreadL( TUid aMediatorPluginUid );
        
        /**
        * Loads plugins
        * @since S60 3.1
        * @param aPtr pointer to CIdle callback instance
        * @return TInt indicating the status of the callback.
        */
        static TInt LoadPlugins( TAny* aPtr );
        
        /**
        * Loads ECom plugins
        * @since S60 3.1
        * @param None.
        * @return None.
        */
        void LoadPluginsL( );
        
        /**
        * Returns count of plugins in this handler
        * @since S60 3.1
        * @param None.
        * @return TInt plugin count.
        */
        TInt PluginCount() { return iPluginImplInfoArray.Count(); }

    private:  // New functions
        
        /**
        * Finds ECom interface implementations
        * @since S60 3.1
        * @param None.
        * @return None.
        */
        void FindImplementationsL();
        
        /**
        * Starts a new thread for given plugin
        * @since S60 3.1
        * @param aMediatorPluginUid UID for the plugin to be loaded
        * @return None.
        */
        static void DoStartThreadL( TUid aMediatorPluginUid );
        
    private:

        /**
        * C++ default constructor.
        */
        CMediatorServerPluginHandler();

        /**
        * By default Symbian 2nd phase constructor is private.
        */
        void ConstructL();

    private:    // Data
        
        /**
        *  A class for passing parameter data for new plugin thread
        *
        *  @lib MediatorServer
        *  @since S60 3.1
        */
        class TMediatorThreadParam
            {
            public:
                // plugin uid
                TUid iMediatorPluginUid;
            };
        
        /**
        * Implementation info of Mediator plugin instances.
        */
        RImplInfoPtrArray iPluginImplInfoArray;
         
        /**
        * To detect idle time 
        * Own.
        */
        CIdle* iIdle;
        
    };

#endif      // MEDIATORSERVERPLUGINHANDLER_H   
            
// End of File