/*

* Copyright (c) 2006-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:  pluginloader which loads home network ECom plugins

*

*/

#ifndef C_UPNPPLUGINLOADER_H

#define C_UPNPPLUGINLOADER_H

// INCLUDE FILES

// System

#include <e32cmn.h>

#include <e32base.h>

#include <gulicon.h>

// upnpframework / home media extension api

#include <upnpplugininterface.h>

class MUPnPPluginLoaderObserver;

/**

 * Loads all the ECom plugins which implement the CUPnPPluginInterface

 * interface

 *

 * @since S60 3.2

 */

NONSHARABLE_CLASS( CUPnPPluginLoader ) : public MUPnPPluginObserver,

                                         public CBase

    {

public: // 1st phase constructor

    /**

     * Returns a pointer to an instance of the CUPnPPluginLoader class

     *

     * @since S60 3.2

     * @param aLoaderObserver reference to the MUPnPPluginLoaderObserver

     * @return Pointer to an instance of the CUPnPPluginLoader class

     */

    IMPORT_C static CUPnPPluginLoader* NewL( MUPnPPluginLoaderObserver& 

        aLoaderObserver );

protected: // 2nd phase constructor

    /**

     * Default constructor

     *

     * @since S60 3.2

     * @param aLoaderObserver reference to the MUPnPPluginLoaderObserver

     */

    CUPnPPluginLoader( MUPnPPluginLoaderObserver& aLoaderObserver );

public: // Destructor

    /**

     * Destructor

     *

     * @since S60 3.2

     */

    IMPORT_C virtual ~CUPnPPluginLoader();

public:

    /**

     * This method creates all ECOM plugins which implement 0x200075DB

     * interface (CUPnPPluginInterface).

     *

     * @since S60 3.2

     * @return Reference to the plugin array. CUPnPMainDialog uses this

     *         reference to draw the UI.

     */

    IMPORT_C const RPointerArray<CUPnPPluginInterface>& CreatePluginsL();

    /**

     * Deletes plugin from iPluginArray which index corresponds the

     * parameter.

     *

     * @since S60 3.2

     * @param aPluginIndex index of plugin to be deleted

     */

    IMPORT_C void DeletePlugin( TInt aPluginIndex );

protected: // From MUPnPPluginObserver

    /**

     * Plugins call this method when they update.

     *

     * @since S60 3.2

     * @param aEvent event from plugin

     */

    void ExtensionEvent( const TExtensionEvent& aEvent );

private:

    /**

     * Pointer array which contains all the plugins

     */

    RPointerArray<CUPnPPluginInterface> iPluginArray;

    /**

     * Pointer to CUPnPPluginLoaderObserver

     * Not own.

     */

    MUPnPPluginLoaderObserver* iLoaderObserver;

    };

#endif // C_UPNPPLUGINLOADER_H

// end of file