/*
* Copyright (c) 2005-2007 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:      Tool for resolving local or remote items - factory
*
*/






#ifndef UPNPITEMRESOLVERFACTORY_H
#define UPNPITEMRESOLVERFACTORY_H

//  INCLUDES
#include <e32base.h>

// FORWARD DECLARATIONS
class MUPnPItemResolver;
class MUPnPAVController;
class MUPnPAVBrowsingSession;
class MUPnPResourceSelector;

// CLASS DECLARATION

/**
* Factory class for constructing MUPnPItemResolver
* implementations. This class only contains static methods.
*
* @lib upnpavcontrollerhelper.lib
* @since S60 3.2
*/
class UPnPItemResolverFactory
    {

public: // construction/destruction

    /**
     * The optimisation flags
     */
    enum TResolverOptimisationFlags
        {
        ENoOptimisation = 0x0000,
            // this is the default
        EOmitLocalMSStart = 0x0001,
            // do not start local MS (in this case it must
            // already started and kept alive the whole time
        EOmitDrmCheck     = 0x0002
            // do not check for file protection (in this case
            // protection check must have been done before)
        };

    /**
     * Creates a resolver for remote content
     * @param aItemId the item ID to resolve into an item
     * @param aHostSession the session where to resolve items
     * @param aSelector selects the desider resource
     * @param aBrowseFilter filter to be used in browse
     * @param aOptimisationFlags flags to optimise resolver behaviour
     * @return instance of RemoteItemResolver
     */
    IMPORT_C static MUPnPItemResolver* NewRemoteItemResolverL(
        const TDesC8& aItemId,
        MUPnPAVBrowsingSession& aHostSession,
        MUPnPResourceSelector& aSelector,
        const TDesC8& aBrowseFilter,
        TInt aOptimisationFlags = ENoOptimisation );

    /**
     * Creates a resolver for local content
     * @param aFilePath the local file to be resolved into an item
     * @param aAvController AVController resource to reserve local media server
     * @param aSelector selects the desider resource
     * @param aOptimisationFlags flags to optimise resolver behaviour
     * @return instance of RemoteItemResolver
     */
    IMPORT_C static MUPnPItemResolver* NewLocalItemResolverL(
        const TDesC& aFilePath,
        MUPnPAVController& aAvController,
        MUPnPResourceSelector& aSelector,
        TInt aOptimisationFlags = ENoOptimisation );

    /**
     * Creates a resolver for remote content that will be resolved and
     * then downloaded to a temporary file in local file system
     * @param aItemId the item ID to resolve into an item
     * @param aAvController AVController resource to reserve local media server
     * @param aHostSession the session where to resolve items
     * @param aSelector selects the desider resource
     * @param aBrowseFilter filter to be used in browse
     * @param aOptimisationFlags flags to optimise resolver behaviour
     * @return instance of RemoteItemResolver
     */
    IMPORT_C static MUPnPItemResolver* NewDownloadItemResolverL(
        const TDesC8& aItemId,
        MUPnPAVController& aAvController,
        MUPnPAVBrowsingSession& aHostSession,
        MUPnPResourceSelector& aSelector,
        const TDesC8& aBrowseFilter,
        TInt aOptimisationFlags = ENoOptimisation );

    };

#endif  // UPNPITEMRESOLVERFACTORY_H

// End of File