/*
* 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:  Manages upnp download
*
*/



#ifndef __CMFMDOWNLOADPROXY_H
#define __CMFMDOWNLOADPROXY_H

#include <e32base.h>

/* Forward declarations. */
class MUPnPAVController;

class CUpnpAVDevice;
class MCmFmTransferObserver;
class CCmFmDownloadMngr;

// CLASS DECLARATION
 
/**
 *  Class represents methods to communication with AV Controller API.
 *
 *  @lib cmfillmanager.lib
 *
 *  @since S60 5.1
 */
NONSHARABLE_CLASS( CCmFmDownloadProxy ): public CBase
    {
 
private:
    
    // Struct containing indexed download session 
    // ( own session for each server )
    struct TCmFmDownloadSessionIndexes
        {
        TInt iDeviceIndex;  // Device index
        TInt iSessionIndex; // Session index
        };

public:

    /**
     * Two-phased constructor.
     *
     * @since S60 5.1
     */
    static CCmFmDownloadProxy* NewL( );
    
    /**
     * Two-phased constructor.
     *
     * @since S60 5.1
     */
    static CCmFmDownloadProxy* NewLC( );

    /**
     * Destructor.
     */
    virtual ~CCmFmDownloadProxy();

public: 
            
    /**
     * Starts to fetch defined file
     *
     * @since S60 5.1
     * @param aObserver, action observer
     * @param aAVController, pointer to av controller
     * @param aDevices, list of devices        
     * @param aResElement, pointer to av controller
     * @param aItem, item to be transferred
     * @param aFile, file reference
     * @param aInternalDeviceIndex, internal device index
     * @param aInternalItemId, internal item index
     * @return None
     */ 
    void FetchFileL( MCmFmTransferObserver* aObserver, 
        MUPnPAVController* aAVController, CUpnpAVDeviceList* aDevices, 
        const CUpnpElement& aResElement, 
        const CUpnpItem& aItem, RFile& aFile, const TInt aInternalDeviceIndex,
        const TInt64 aInternalItemId );
   
    /**
     * Closes download session
     *
     * @since S60 5.1
     * @param aSessionId, session to be closed
     * @return ETrue, if sessions left
     */    
    TBool CloseDownloadSession( const TInt aSessionId );
    
    /**
     * Cancel UPnP operation download
     *
     * @since S60 5.1
     * @param None
     * @return None
     */    
    void CancelOperation();
    
private:

    /**
     * Starts new download session if session to 
     * defined device doesn't already exist.
     *
     * @since S60 5.1
     * @param aObserver, action observer
     * @param aAVController, pointer to av controller
     * @param aDevices, list of devices       
     * @param aInternalDeviceIndex, internal device index
     * @return index of the used session
     */    
    TInt StartNewDownloadSessionIfNeededL( MCmFmTransferObserver* aObserver, 
        MUPnPAVController* aAVController, 
        CUpnpAVDeviceList* aDevices, 
        const TInt aInternalDeviceIndex );

    /**
     * Creates new download session
     *
     * @since S60 5.1
     * @param aObserver, action observer
     * @param aAVController, pointer to av controller
     * @param aDevices, list of devices       
     * @param aSessionCount, session count
     * @param aSessionIndex, ref to session index
     * @return index of the used session
     */        
    void CreateNewSessionL(  
        MCmFmTransferObserver* aObserver, MUPnPAVController* aAVController, 
        CUpnpAVDeviceList* aDevices, TInt aSessionCount, 
        TInt& aSessionIndex );                              
                           
private:

    /**
     * Performs the first phase of two phase construction.
     */
    CCmFmDownloadProxy( );

    /**
     * Performs the second phase construction.
     */
    void ConstructL();
    

private:
    
    /**
     * Download sessions
     */
    RPointerArray<CCmFmDownloadMngr> iDownloadSessions;
    
    /**
     * Indexed array for download sessions
     */
    RArray<TCmFmDownloadSessionIndexes> iSessionIndexes;
    
    /**
     * Count of download session
     */
    TInt iDownloadSessionCount;
    
    };

#endif //  __CMFMDOWNLOADPROXY_H