/*

 * Copyright (c) 2009 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:  Phonebook 2 merge contacts resolver.

 *

 */

#ifndef CPBK2MERGERESOLVER_H_

#define CPBK2MERGERESOLVER_H_

// INCLUDES

#include <e32base.h>

#include <MVPbkStoreContactField.h>

#include <TVPbkFieldVersitProperty.h>

#include <MVPbkFieldType.h>

#include <Pbk2FieldProperty.hrh>

#include <MPbk2MergeResolver.h>

#include "CPbk2MergeConflict.h"

// FORWARD DECLARATIONS

class CPbk2PresentationContact;

// CLASS DECLARATION

/**

 * Phonebook 2 merge contacts resolver.

 */

class CPbk2MergeResolver : public CBase, 

                           public MPbk2MergeResolver

    {

public: // Construction and destruction

    /**

     * Creates a new instance of this class.

     *

     * @param aFirstContact     First contact to merge.

     * @param aSecondContact    Second contact to merge.

     * 

     * @return  A new instance of this class.

     */

    static CPbk2MergeResolver* NewL( 

            CPbk2PresentationContact* aFirstContact, 

            CPbk2PresentationContact* aSecondContact );

    /**

     * Destructor.

     */

    ~CPbk2MergeResolver();

public: // Implementation

    /**

     * Starts merging.

     */

    void MergeL();

    /**

     * Counts conflicts.

     *

     * @return  Number of conflicts.

     */

    TInt CountConflicts();

    /**

     * Gets conflict.

     *

     * @param aConflict    Index of conflict in array.

     * @return  Base class of conflict.

     */

    MPbk2MergeConflict& GetConflictAt( TInt aConflict );

    /**

     * Counts merged.

     *

     * @return  Number of merged.

     */

    TInt CountMerged();

    /**

     * Gets merged.

     *

     * @param aMerged    Index of merged in array.

     * @return  Base class of conflict.

     */

    MVPbkStoreContactField& GetMergedAt( TInt aMerged );

private: // Construction

    CPbk2MergeResolver( 

            CPbk2PresentationContact* aFirstContact, 

            CPbk2PresentationContact* aSecondContact );

private: // Declaration

    enum ECompareAddress

        {

        ECAUndefined,

        ECASame,

        ECAFirstIncludesSecond,

        ECASecondIncludesFirst,

        ECADifferent

        };

private: // Implementation

    TBool EqualsValues( 

            const MVPbkStoreContactField& aFieldFirst,

            const MVPbkStoreContactField& aFieldSecond );

    ECompareAddress CompareAddresses( TPbk2FieldGroupId aGroupId );

    CPbk2MergeResolver::ECompareAddress DoCompareAddresses( 

            TInt aCountEquals, 

            TInt aCountAddressFieldsFirst,

            TInt aCountAddressFieldsSecond );

    TBool AreFieldsTypeSame( 

            const MVPbkStoreContactField& aFieldFirst,

            const MVPbkStoreContactField& aFieldSecond );

    TBool AreAddressesSubTypeSame( 

            const MVPbkStoreContactField& aFieldFirst,

            const MVPbkStoreContactField& aFieldSecond );

    TBool AddressField( const MVPbkStoreContactField& aField );

    void CopyAddressToMergedL( 

            const CPbk2PresentationContact& aContact, 

            TPbk2FieldGroupId aAddressGroup );

    TPbk2FieldMultiplicity FieldMultiplicity( const MVPbkStoreContactField& aField );

    void AddConflictL( 

            const MVPbkStoreContactField& aFieldFirst,

            const MVPbkStoreContactField& aFieldSecond );

    HBufC* SyncDisplayFieldLC(

            const MVPbkStoreContactField& aField );

    HBufC* LocaliseSyncDisplayFieldLC( const TDesC& aContent );

    void AddAddressConflictL( TPbk2FieldGroupId aGroupId );

    TInt FindConflictByFieldL( const MVPbkStoreContactField& aField );

    void PrintFieldL(const MVPbkStoreContactField & aField);

    void MergeAddressesL();

    void CompleteMergeArrL(

            RArray<TInt>& aDuplicatesInFirst, 

            RArray<TInt>& aDuplicatesInSecond );

    TBool IsTopContactField( 

            const MVPbkStoreContactField& aField );

    TInt CompareTopConactFields( 

                const MVPbkStoreContactField& aFieldFirst,

                const MVPbkStoreContactField& aFieldSecond );

private: // Data

    // Own: Array merged contact fields

    RPointerArray<MVPbkStoreContactField> iMerged; 

    // Own: Array conflicted contact fields

    RPointerArray<MPbk2MergeConflict> iConflicts;

    // Own: First contact  

    CPbk2PresentationContact* iFirstContact;

    // Own: Second contact  

    CPbk2PresentationContact* iSecondContact;

    };

#endif /* CPBK2MERGERESOLVER_H_ */