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


#ifndef IA_UPDATE_CONTENT_OPERATION_H
#define IA_UPDATE_CONTENT_OPERATION_H


#include <e32base.h>
#include "iaupdateoperation.h"

class CIAUpdateBaseNode;
class MIAUpdateContentOperationObserver;


/**
 * CIAUpdateContentOperation is an abstract base class
 * for node content operations.
 */
class CIAUpdateContentOperation : public CBase,
                                  public MIAUpdateOperation
    {

public:

    /**
     * Destructor
     */
    virtual ~CIAUpdateContentOperation();


public: // MIAUpdateOperation 

    /**
     * @see MIAUpdateOperation::StartOperationL
     *
     * @note Notice, return value is always EFalse 
     * because this implementation does only checkings but
     * does not start operation. Also, iInUse flag is left
     * to EFalse. So, it is child classes resonsibility set the
     * correct iInUse flag if operation is started. 
     *
     * @return TBool EFalse always.
     */
    virtual TBool StartOperationL();
 
    /**
     * @see MIAUpdateOperation::StartOperationL
     */
    virtual void CancelOperation() = 0;


protected:

    /**
     * Constructor
     *
     * @param aNode Node of this operation.
     * @param aObserver The observer whose call back will be called
     * when operation is finished.     
     */ 
    CIAUpdateContentOperation( CIAUpdateBaseNode& aNode,
                               MIAUpdateContentOperationObserver& aObserver );

    /**
     * 2nd. phase constructor
     */ 
    virtual void ConstructL();


    /**
     * Called when operation completes.
     *
     * @param aError Error code
     */
    void OperationComplete( TInt aError );
    

    /**
     * Called when operation progresses.
     */
    void OperationProgress( TInt aProgress, TInt aMaxProgress );
    

    /**
     * @return CIAUpdateBaseNode& Node whose operation is going on.
     */
    CIAUpdateBaseNode& Node() const;


    /**
     * @return MIAUpdateContentOperationObserver& Operation observer.
     */    
    MIAUpdateContentOperationObserver& Observer() const; 


    /**
     * @return TBool ETrue if the operation is going on. Else EFalse. 
     */
    TBool OperationInUse() const;


    /**
     * @param aInUse ETrue if the operation is going on. Else EFalse. 
     */
    void SetOperationInUse( TBool aInUse );


private:
    
    // Prevent these if not implemented
    CIAUpdateContentOperation( 
        const CIAUpdateContentOperation& aObject );
    CIAUpdateContentOperation& operator =( 
        const CIAUpdateContentOperation& aObject );

    
private: // data

    // The node that is given when the operation is created.
    CIAUpdateBaseNode& iNode;

    // The observer that is given when the operation is created.
    MIAUpdateContentOperationObserver& iObserver;

    // This flag informs if the operation is going on.
    TBool iInUse;

    };

#endif // IA_UPDATE_CONTENT_OPERATION_H