/*
* 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 __CMFMDOWNLOADMNGR_H
#define __CMFMDOWNLOADMNGR_H

#include <e32base.h>
#include <f32file.h>
#include "upnpfiletransfersessionobserver.h"

/* Forward declarations. */
class MUPnPAVController;
class CUpnpAVDevice;
class MCmFmTransferObserver;

// CLASS DECLARATION
 /**
  *  Class represents methods to communication with AV Controller API.
  *
  *  @lib cmfillmanager.lib
  *
  *  @since S60 5.1
  */
NONSHARABLE_CLASS( CCmFmDownloadMngr ): public CBase,
                          public MUPnPFileTransferSessionObserver
    {

public:

    /**
     * Two-phased constructor.
     *
     * @since S60 5.1
     * @param aAVController, av controller
     * @param aObserver, action observer
     * @param aDevice, device
     * @param aDownloadId, id for the download manager
     * @return  pointer to CCmFmDownloadMngr class
     */
    static CCmFmDownloadMngr* NewL( MUPnPAVController* aAVController, 
        MCmFmTransferObserver* aObserver, const CUpnpAVDevice& aDevice,
        const TInt aDownloadId  );
    
    /**
     * Two-phased constructor.
     *
     * @since S60 5.1
     * @param aAVController, av controller
     * @param aObserver, action observer
     * @param aDevice, device      
     * @param aDownloadId, id for the download manager
     * @return  pointer to CCmFmDownloadMngr class
     */
    static CCmFmDownloadMngr* NewLC( MUPnPAVController* aAVController, 
        MCmFmTransferObserver* aObserver, const CUpnpAVDevice& aDevice,
        const TInt aDownloadId  );

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

public: 
        
    /**
    * Starts to fetch defined file
    *
    * @since S60 5.1
    * @param aResElement, pointer to av controller
    * @param aItem, item to be transferred
    * @param aFile, file to be downloaded
    * @param aInternalItemId, internal item index
    * @return None
    */ 
    void FetchFileL( const CUpnpElement& aResElement, 
        const CUpnpItem& aItem, RFile& aFile, const TInt64 aInternalItemId );
    
    /**
    * Cancel UPnP operation
    *
    * @since S60 5.1
    * @param None
    * @return None
    */    
    void CancelOperation();

protected: 
    
// From base class MUPnPFileTransferSessionObserver

    /**
     * From MUPnPFileTransferSessionObserver
     * @see base class definition
     */
    void TransferStarted( TInt aKey, TInt aStatus );
 
    /**
     * From MUPnPFileTransferSessionObserver
     * @see base class definition
     */
     void TransferCompleted( TInt aKey, TInt aStatus,
                             const TDesC& aFilePath );
    
    /**
     * From MUPnPFileTransferSessionObserver
     * @see base class definition
     */
    void TransferProgress( TInt aKey, TInt aBytes, TInt aTotalBytes );

    /**
     * From MUPnPFileTransferSessionObserver
     * @see base class definition
     */        
    void MediaServerDisappeared( TUPnPDeviceDisconnectedReason aReason );
                           
private:

    /**
     * Performs the first phase of two phase construction.
     *
     * @since S60 5.1
     * @param aAVController, av controller
     * @param aObserver, transfer observer
     * @param aDownloadId, download manager id
     */
    CCmFmDownloadMngr( MUPnPAVController* aAVController, 
        MCmFmTransferObserver* aObserver, const TInt aDownloadId );

    /**
     * Performs the second phase construction.
     * @since S60 5.1
     * @param aDevice, UPnP server
     */
    void ConstructL( const CUpnpAVDevice& aDevice );
    

private:
    
    /**
     * AV Controller
     */
    MUPnPAVController* iAVController;                   // Not owned
    
    /**
     * File transfer Observer
     */
    MCmFmTransferObserver* iObserver;                   // Not owned
    
    /**
     * Download manager id. Proxy identifies managers with this id
     */
    TInt iDownloadId;
    
    /**
     * Download session
     */
    MUPnPFileDownloadSession* iDownloadSession;         // Not owned

    /**
     * Size of transferred file
     */
    TInt64 iFileSize;
    
    };

#endif //  __CMFMDOWNLOADMNGR_H