/*

* 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:  An operation for Updating a contact in the store

*

*/

#ifndef CVPbkImportToContactsMergeOperation_H

#define CVPbkImportToContactsMergeOperation_H

// INCLUDE FILES

#include <e32base.h>

#include <MVPbkContactOperationBase.h>

#include <MVPbkSingleContactOperationObserver.h>

#include <MVPbkContactObserver.h>

#include <MVPbkContactOperation.h>

#include <MVPbkContactAttributeManager.h>

#include <VPbkFieldType.hrh>

#include "MVPbkImportOperationImpl.h"

#include "CVPbkGroupCardHandler.h"

#include "MVPbkContactCopyObserver.h"

// FORWARD DECLARATIONS

class MVPbkStoreContact;

class MVPbkContactStore;

class MVPbkSingleContactOperationObserver;

class MVPbkContactLink;

class MVPbkStoreContactField;

class MVPbkFieldType;

class MVPbkSingleContactOperationObserver;

class MVPbkContactCopyObserver;

class CVPbkVCardEng;

class CVPbkVCardImporter;

class CVPbkContactManager;

class MVPbkSetAttributeObserver;

/**

 *  An operation for Updating a contact in the store

 */

NONSHARABLE_CLASS(CVPbkImportToContactsMergeOperation) 

    :   public CActive,

        public MVPbkContactOperation,

        public MVPbkImportOperationObserver,

        public MVPbkSingleContactOperationObserver,

        public MVPbkContactObserver,

        public MVPbkSetAttributeObserver

    {

public:

     static CVPbkImportToContactsMergeOperation *NewL( 

             TVPbkImportCardType aType,

             CVPbkVCardData& aData, 

             const MVPbkContactLink& aReplaceContact, 

             MVPbkContactStore& aTargetStore, 

             RReadStream& aSourceStream, 

             MVPbkSingleContactOperationObserver& aObserver );

    /**

    * Destructor.

    */

    ~CVPbkImportToContactsMergeOperation();

protected: // CActive

    /**

    * From CActive. Called when asynchronous operation completes.

    */

    void RunL();

    /**

    * From CActive. Called when RunL leaves.

    */    

    TInt RunError( TInt aError );

    /**

    * From CActive. Cancels operation.

    */

    void DoCancel();        

private:

    CVPbkImportToContactsMergeOperation( 

            const MVPbkContactLink& aReplaceContact,

            MVPbkSingleContactOperationObserver& aObserver,

            MVPbkContactStore& aTargetStore,

            CVPbkVCardData & aData

            );

    /**

    * Second phase constructor.

    */

    void ConstructL( TVPbkImportCardType aType, RReadStream& aSourceStream);

public:

    // from base class MVPbkImportOperationObserver

      /**

        * From MVPbkImportOperationObserver  

        * Called when a contact import operation has Completed.

        */

     void ContactsImported();

      /**

        * From MVPbkImportOperationObserver  

        * Called when a contact import operation has failed.

        */

     void ContactImportingFailed( TInt aError );

      /**

        * From MVPbkImportOperationObserver  

        * Called when a contact import operation has Completed Fully.

        */

     void ContactsImportingCompleted();

public:

    // from base class MVPbkContactOperation

     /**

        * From MVPbkContactOperation  

        * Called when a contact operation has to be started

        */

     void StartL();

      /**

        * From MVPbkContactOperation  

        * Called when a contact operation has to be cancled

        */

     void Cancel();

public: // from MVPbkSingleContactOperationObserver

    /**

        * From MVPbkSingleContactOperationObserver  

        * Called when the contact operation is complete

        * Client takes Ownership in deleting returned aContact.

        */

    void VPbkSingleContactOperationComplete(

                    MVPbkContactOperationBase& aOperation,

                    MVPbkStoreContact* aContact );

    /**

        * From MVPbkSingleContactOperationObserver  

        * Called when the contact operation fails

        */                

    void VPbkSingleContactOperationFailed(

                    MVPbkContactOperationBase& aOperation, 

                    TInt aError );

public:

    // from MVPbkContactObserver

    /**

        * From MVPbkContactObserver  

        * Called when a contact operation has succesfully completed.

        * Client takes Ownership in deleting returned aResult.

        */

    void ContactOperationCompleted(TContactOpResult aResult);

    /**

        * From MVPbkContactObserver  

        * Called when a contact operation has failed.

        */

    void ContactOperationFailed

                (TContactOp aOpCode, TInt aErrorCode, TBool aErrorNotified);

private:

    // from MVPbkSetAttributeObserver

    /**

        * From MVPbkSetAttributeObserver  

        * Called when a set attribute operation has succesfully completed.

        * Client takes Ownership in deleting returned aResult.

        */

    void AttributeOperationComplete( MVPbkContactOperationBase& aOperation );

    /**

        * From MVPbkSetAttributeObserver  

        * Called when a set attribute operation has failed.

        */

    void AttributeOperationFailed(

            MVPbkContactOperationBase& aOperation,

            TInt aError );

private: // types

    enum TState

        {

        EImport,

        ERetrieve,

        ELock,

        EUpdateContact,

        EReplaceFields,

        ESetAttributes,

        ECommit,

        EReRetrieve, //Reload contact to have valid lastmodified datetime

        EComplete

        };

private:    

    void NextState( TState aNextState );

    /**

    * Retrive the contact to be updated

    */

    void RetrieveContactL();

    /**

    * Lock the contact for editing

    */

    void LockContactL();

    /**

    * Commit the updated contact

    */

    void CommitContactL();

    /**

    * Update imported contacts

    */

    void UpdateContactL();

    /**

    * Retrieve the contact after updation

    */

    void ReRetrieveContactL();

    void HandleError(TInt aError);

    void HandleContactReplacing(MVPbkStoreContact* aContact);

    /**

    * Replace the fields of target contact

    */

    void ReplaceFieldL( const MVPbkStoreContact& aSrc, MVPbkStoreContact& aTarget );

    /**

    * Copy the fields of source contact to target contact

    */

    void CopyFieldL( const MVPbkStoreContactField& aSourceField,

            const MVPbkFieldType& aType,

            MVPbkStoreContact& aTargetContact );

    /**

    * Gets the attributes from aField

    */

    void GetDefaultAttributsL( const MVPbkStoreContactField& aField );

    /**

    * Return the attribute which is to be set

    */

    TVPbkDefaultType NextAttribute();

    /**

    * Set the attribute to the target contect field

    */

    void SetNextL();

private: // data

    /// Own: state

    TState iState;

    /// Own: the imported contacts

    RPointerArray<MVPbkStoreContact> iImportedContacts;

    /// Own: the implementation of the import operation

    MVPbkImportOperationImpl* iOperationImpl;

    /// Ref: the target store of the operation

    MVPbkContactStore& iTargetStore;

    /// Ref: Vcard Data

    CVPbkVCardData& iData;

    /// Ref: contact to replace

    const MVPbkContactLink& iReplaceContact;

    /// Own: current contact

    MVPbkStoreContact* iContact;

    /// Ref: client that waits importing

    MVPbkSingleContactOperationObserver& iObserver;

    /// Own: the operation for import and retrieve

    MVPbkContactOperationBase* iVPbkOperation;

    /// Own: Group Card Handler

    CVPbkGroupCardHandler* iGroupcardHandler;

    /// Own: the operation for set attribute

    MVPbkContactOperationBase* iSetAttributeOperation;

    /// Own: the array of one field's attributes

    CArrayFixFlat<TVPbkDefaultType>* iDefaultAttributes;

    /// The index of the current operated field 

    TInt iCurrentFieldIndex;

    /// The field count of the source contact

    TInt iFieldCount;

    };

#endif