/*

* 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:   CIAUpdateNormalContentOperation 

*

*/

#ifndef IA_UPDATE_NORMAL_CONTENT_OPERATION_H

#define IA_UPDATE_NORMAL_CONTENT_OPERATION_H

#include "iaupdatecontentoperation.h"

class MNcdOperation;

class TNcdProgress;

class MNcdQuery;

/**

 * CIAUpdateNormalContentOperation is an abstract base class

 * for normal node content operations.

 */

class CIAUpdateNormalContentOperation : public CIAUpdateContentOperation

    {

public:

    /**

     * Destructor

     */

    virtual ~CIAUpdateNormalContentOperation();

protected: // CIAUpdateContentOperation

    /**

     * @see CIAUpdateContentOperation::StartOperationL

     */

    virtual TBool StartOperationL();

    /**

     * @see CIAUpdateContentOperation::CancelOperation

     */

    virtual void CancelOperation();

protected:

    /**

     * @see CIAUpdateContentOperation::CIAUpdateContentOperation

     */ 

    CIAUpdateNormalContentOperation(

        CIAUpdateBaseNode& aNode,

        MIAUpdateContentOperationObserver& aObserver );

    /**

     * 2nd. phase constructor

     */ 

    virtual void ConstructL();

    /**

     * @return MNcdOperation* Pointer to the operation that was started.

     * NULL if operation was not needed for this node content.

     * @exception Leaves with system wide error code.

     */ 

    virtual MNcdOperation* HandleContentL() = 0;

    /**

     * Query received related to the content operation.

     *

     * This is meant for the operation observing.

     * Child classes may use this function when their

     * callbacks are called.

     *

     * @param aOperation Operation that requests query.

     * @param aQuery Query that requires response.

     */ 

    void ContentQueryReceived( MNcdOperation& aOperation, 

                               MNcdQuery* aQuery );

    /**

     * This is meant for the operation observing.

     * Child classes may use this function when their

     * callbacks are called.

     *

     * @param aOperation Operation that completed.

     * @param aError Error code for the operation completion.

     */

    void ContentOperationComplete( MNcdOperation& aOperation, 

                                   TInt aError );

private:

    // Prevent these if not implemented

    CIAUpdateNormalContentOperation( 

        const CIAUpdateNormalContentOperation& aObject );

    CIAUpdateNormalContentOperation& operator =( 

        const CIAUpdateNormalContentOperation& aObject );

    // This will call Release to existing operation, if it exists,

    // Ownership of aOperation is transferred.

    void SetOperation( MNcdOperation* aOperation );

private: // data

    // This is released and set to NULL when a corresponding 

    // operation finishes.

    MNcdOperation* iOperation;

    };

#endif // IA_UPDATE_NORMAL_CONTENT_OPERATION_H