/*

* Copyright (c) 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:  Interface class for WMDRM DLA HTTP FW plugin resolver

*

*/

#ifndef WMDRMDLAHTTPFWPLUGINRESOLVER_H

#define WMDRMDLAHTTPFWPLUGINRESOLVER_H

#include <e32base.h>

class CWmDrmDlaPluginContainer;

class CAknIconArray;

/**

 *  WMDRM DLA HTTP FW Plugin resolver interface

 *

 *  @lib wmdrmdla.lib

 *  @since S60 v9.1

 */

class WmDrmDlaHttpFwPluginResolver

    {

public:

    /**

     * Resolves HTTP plugin for the WMDRM file

     *

     * @param   aFile WMDRM file

     * @param   aHttpPlugin Contains resolved HTTP Plugin on return. 

     * @param   aUiNotifier Contains initialized UiNotifier on return. 

     *                      Can be NULL

     * @leave   KErrNotFound if there is no handler for the file

     */

    static void ResolveHttpPluginL( const RFile& aFile, 

                                    CWmDrmDlaHttpPluginIf*& aHttpPlugin,

                                    CWmDrmDlaUiNotifier*& aUiNotifier );

    /**

     * Resolves HTTP plugin for the DRM header

     *

     * @param   aDrmHeader DRM header

     * @param   aHttpPlugin Contains resolved HTTP Plugin on return. 

     * @param   aUiNotifier Contains initialized UiNotifier on return. 

     *                      Can be NULL

     * @leave   KErrNotFound if there is no handler for the header

     */

    static void ResolveHttpPluginL( const TDesC8& aDrmHeader, 

                                    CWmDrmDlaHttpPluginIf*& aHttpPlugin,

                                    CWmDrmDlaUiNotifier*& aUiNotifier );

    /**

     * Resolves HTTP plugin for the metering certificate

     *

     * @param   aCertificate Metering certificate

     * @param   aHttpPlugin Contains resolved HTTP Plugin on return. 

     * @param   aUiNotifier Contains initialized UiNotifier on return. 

     *                      Can be NULL

     * @leave   KErrNotFound if there is no handler for the certificate

     */

    static void ResolveHttpPluginWithCertificateL( 

                        const TDesC8& aCertificate,

                        CWmDrmDlaHttpPluginIf*& aHttpPlugin, 

                        CWmDrmDlaUiNotifier*& aUiNotifier );

private:

    /**

     * Selects HTTP plugin from supported plugins. Will query from the user

     * which plugin to use, if more that one plugin supports the current content.

     *

     * @param   aSupportedPluginArray Array of supported plugins

     * @param   aImplArray Array of plugins that implement WMDRM DLA HTTP

     *                     plugin interface

     * @param   aHttpPlugin Contains resolved HTTP Plugin on return. 

     * @param   aUiNotifier Contains initialized UiNotifier on return. 

     *                      Can be NULL

     * @leave   KErrNotFound if there isn't any plugins

     */

    static void SelectPluginL( 

                RPointerArray<CWmDrmDlaPluginContainer>& aSupportedPluginArray,

                RImplInfoPtrArray& aImplArray,

                CWmDrmDlaHttpPluginIf*& aHttpPlugin, 

                CWmDrmDlaUiNotifier*& aUiNotifier );

    /**

     * Loads the default icon and appends it to the icon array

     *

     * @param   aIconArray Array where loaded default icon is appended

     * @leave   Standard Symbian error code

     */

    static void DefaultIconL( CAknIconArray*& aIconArray );

    };

#endif // WMDRMDLAHTTPFWPLUGINRESOLVER_H