/*
* Copyright (c) 2005 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:  Handler to synchronize contact list
*
*/

#ifndef __CPENGCONTACTLISTTRANSSYNC_H__
#define __CPENGCONTACTLISTTRANSSYNC_H__

//  INCLUDES
#include "CPEngContactListTransBase.h"


// CLASS DECLARATION
class MPEngXMLSerializer;
class CPEngContactListModItemContainer;


/**
 * Handler to synchronize contact list
 *
 * @lib PEngListLib2
 * @since 3.0
 */
NONSHARABLE_CLASS( CPEngContactListTransSync ):
        public CPEngContactListTransBase
    {
public:

    /**
     * Two-phased constructor.
     */
    static CPEngContactListTransSync* NewLC(
        CPEngContactListModBase& aContactList,
        CPEngSessionSlotId& aSessionSlotId,
        MPEngContactListTransactionManager& aManager,
        TPEngWVCspVersion& aCSPVersion,
        TInt aOperationId );

    /**
     * Destructor.
     */
    virtual ~CPEngContactListTransSync();


public: // From MPEngOutgoingTransactionHandler

    /**
     *  Support for simultaneous transaction handling
     *  @see <MPEngOutgoingTransactionHandler.h>
     */
    void NewTransactionHandlersL(
        RPointerArray<MPEngOutgoingTransactionHandler>& aTransactionsArray );


protected: // From CPEngContactListTransBase

    /**
     * Create XML message to create contact list
     * @see <CPEngContactListTransBase.h>
     */
    void DoGetXMLCreateCntListL( MPEngXMLSerializer& aXmlSerializer );


    /**
     * Parse contact list create XML response
     * @see <CPEngContactListTransBase.h>
     */
    void DoParseCreateCntListResponseL( const TDesC8& aResponse,
                                        MPEngXMLParser& aXMLparser );

    /**
     * Create XML message to fetch contact list
     * @see <CPEngContactListTransBase.h>
     */
    void DoGetXMLFetchCntListL( MPEngXMLSerializer& aXmlSerializer );


    /**
     * Parse contact list fetch XML response
     * @see <CPEngContactListTransBase.h>
     */
    void DoParseFetchCntListResponseL( const TDesC8& aResponse,
                                       MPEngXMLParser& aXMLparser );


private:

    /**
     * Parses contact list properties
     *
     * @since 3.0
     * @param aResponse buffer with request response
     * @param aXMLparser1 XML parser
     * @param aXMLparser1 XML parser
     */
    void ParsePropertiesL( const TDesC8& aResponse,
                           MPEngXMLParser& aXMLparser1,
                           MPEngXMLParser& aXMLparser2 );

    /**
     * Create Master contact list update handlers
     *
     * @since 3.0
     */
    void CreateMasterCntListUpdateHandlersL();



private: // Constructors

    /**
     * C++ constructor.
     */
    CPEngContactListTransSync( CPEngContactListModBase& aContactList,
                               CPEngSessionSlotId& aSessionSlotId,
                               MPEngContactListTransactionManager& aManager,
                               TPEngWVCspVersion& aCSPVersion,
                               TInt aOperationId );

    /**
     * Symbian constructor.
     */
    void ConstructL();


private:    // Data

    /// OWN: Additional handlers
    RPointerArray<MPEngOutgoingTransactionHandler>  iAdditionalHandlers;
    };

#endif      //  __CPENGCONTACTLISTTRANSSYNC_H__

//  End of File