/*
* Copyright (c) 2006 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:  
*
*/


#ifndef C_NCDDOWNLOADSUBOPERATION_H
#define C_NCDDOWNLOADSUBOPERATION_H

#include <e32base.h>

#include "ncdbaseoperation.h"
#include "ncdoperationdatatypes.h"
#include "ncddownloadoperationstates.h"
#include "catalogshttptypes.h"
#include "catalogshttpobserver.h"
#include "ncdoperationobserver.h"

class RWriteStream;
class RReadStream;

class MCatalogsHttpSession;
class MCatalogsHttpConfig;
class MCatalogsHttpOperation;
class MCatalogsHttpHeaders;
class CNcdGeneralManager;

/** 
 * Download operation
 *
 * @ Add username & password -handling
 * @ Add observers if this is used by other operations
 */
class CNcdDownloadSubOperation : public CNcdBaseOperation,
    public MCatalogsHttpObserver
    {
public:
    
    /**
     * NewL
     *
     * @param aHttpSession HTTP session used for creating download operations
     * @param aDestination Destination directory if the descriptor ends in '\'
     * otherwise full destination path (path + filename)
     *
     * @note Preferably the HTTP session has suitable defaults but if not then
     * Config() can be used to retrieve and change the settings for the download.
     * @note At least the target directory and access point must be set to the 
     * configuration.
     *    
     */
    static CNcdDownloadSubOperation* NewL( 
        CNcdGeneralManager& aGeneralManager,
        MCatalogsHttpSession& aHttpSession,
        const TDesC& aUri,
        const TDesC& aDestination,
        MNcdOperationObserver& aObserver,
        MCatalogsSession& aSession );


    /**
     * NewL
     *
     * Internalizes a download operation from a stream
     */
    static CNcdDownloadSubOperation* NewL( 
        CNcdGeneralManager& aGeneralManager,
        MCatalogsHttpSession& aHttpSession,
        MNcdOperationObserver& aObserver,
        RReadStream& aStream,
        MCatalogsSession& aSession );
        
    
    /**
     * Destructor
     */
    virtual ~CNcdDownloadSubOperation();
    
public: // New methods

    /** 
     * HTTP configuration getter. 
     */
    MCatalogsHttpConfig& Config();
    
    /**
     * HTTP request headers getter
     */
    MCatalogsHttpHeaders& RequestHeaders();
    
    const MCatalogsHttpHeaders& ResponseHeadersL();
    
    /**
     * Download operation getter
     */
    MCatalogsHttpOperation& HttpOperation();
    
    
public: // From CNcdBaseOperation

    /**
     * Starts the operation.
     */
    TInt Start();


    /**
     *
     */
    TInt Pause();
    
    
    TInt Resume();
    
    /**
     * @see CNcdBaseOperation::Cancel()
     */
    void Cancel();    
    

public: // From MCatalogsHttpObserver

    /**
     * @see MCatalogsHttpObserver::HandleHttpEvent()
     */
    void HandleHttpEventL( 
        MCatalogsHttpOperation& aOperation, 
        TCatalogsHttpEvent aEvent );
        
    /**
     * @see MCatalogsHttpObserver::HandleHttpError()
     */
    TBool HandleHttpError(
        MCatalogsHttpOperation& aOperation,
        TCatalogsHttpError aError );


public:
       
    /**
     * Externalize
     *
     * @param aStream Target stream
     */ 
    void ExternalizeL( RWriteStream& aStream ) const;
    
    
    /**
     * Internalize
     *
     * @param aStream Source stream
     */
    void InternalizeL( RReadStream& aStream ); 


protected: // From CNcdBaseOperation

    /**
     * @see CNcdBaseOperation::RunOperation()
     */
    TInt RunOperation();        
    
    
protected:

    // Constructor
    CNcdDownloadSubOperation(  
        CNcdGeneralManager& aGeneralManager,
        MCatalogsHttpSession& aHttpSession,
        MCatalogsSession& aSession );
        
    void ConstructL( 
        const TDesC& aUri, 
        const TDesC& aDestination,
        MNcdOperationObserver& aObserver );


    void ConstructL( 
        MNcdOperationObserver& aObserver );

private:

    void NotifyObserversComplete( TInt aError );
    
    void NotifyObserversProgress();    
        
private:

    MCatalogsHttpSession& iHttpSession;
    MCatalogsHttpOperation* iDownload;
    TNcdDownloadState iDownloadState;        
    };

#endif // C_NCDDOWNLOADSUBOPERATION_H