/*

* Copyright (c) 2008-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:  Plugin manager, responsible to load the plugins.

*

*/

#ifndef C_PLUGINMANAGER_H

#define C_PLUGINMANAGER_H

#include <e32base.h>

#include <e32hashtab.h>

class REComSession;

class CMusicContentPublisher;

/**

 *  Plugin manager.

 *  Class used to manage the the ECOM plugins

 *  @since S60 S60 v5.0

 */

class CPluginManager : public CActive

    {

public:

    /**

     * Standard Symbian 2 phase constructor

     */

    static CPluginManager* NewL( TUid aUid, TAny *aParameter , CMusicContentPublisher* aContentPublisher );

    /**

     * Standard Symbian 2 phase constructor

     */

    static CPluginManager* NewLC( TUid aUid, TAny *aParameter , CMusicContentPublisher* aContentPublisher  );

    /**

     * Standard C++ destructor.

     */

    ~CPluginManager();

    /**

     * Gets plugin with provided UID

     *

     * @param aUid required plugin

     * @return pointer to plugin implementation

     */

    TAny* GetImplementation( TUid aUid );

    /**

     * Gets plugin with provided index

     *

     * @param aIndex index of plugin

     * @return pointer to plugin implementation

     */

    TAny* GetImplementation( TInt aIndex );

    /**

     * Gets number of plugins

     *

     * @return number of plugins

     */

    TInt GetCount();

protected:

    /**

     * From CActive, RunL.

     * Handles the active object’s request completion event

     */

    void RunL();

    /**

     * From CActive, DoCancel.

     * Implements cancellation of an outstanding request.

     */

    void DoCancel();

    /**

     * From CActive, RunError.

     * Method called when leave occured in RunL

     */

    TInt RunError( TInt aError );

private:

    /**

     * C++ default constructor.

     */

    CPluginManager( TUid aUid, TAny *aParameter, CMusicContentPublisher* aContentPublisher );

    /**

     * Perform the second phase construction of a CPluginManager object.

     */

    void ConstructL();

    /**

     * Loads ECOM plugins

     */

    void LoadPluginsL();

    /**

     * Cleans plugins table;

     */

    void CleanPluginsTable();

private: //data

    /**

     * ECOM handler

     * Own.

     */

    REComSession* iSession;

    /**

     * Map containing plugins

     * Own.

     */

    RHashMap< TInt32, TAny*> iPluginMap;

    /**

     * UID of the interface

     */

    const TUid iUid;

    /**

     * Parameter to pass to the object creation method.

     */

    TAny* iParameter;

    /**

     * Content Publisher / Parent, not owned.

     */

    CMusicContentPublisher* iContentPublisher;

    };

#endif // C_PLUGINMANAGER_H

//  End of File