/*

* Copyright (c) 2007 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:    Interacts with the central respository, and the internal data 

*                file to store and restore data.

*

*/

#ifndef C_PDCDATA_H

#define C_PDCDATA_H

// System includes

#include <e32base.h>        // CBase

#include <sysutil.h>        // KSysUtilVersionTextLength

// Forward declarations

class RFs;

class CRepository;

class RReadStream;

class RWriteStream;

class CVPbkContactLinkArray;

/**

 *  Predefined Contacts engine

 *  This class is the reponsible for

 *  deciding if predefined contacts need to be added,

 *  and persisting the ids of any contacts added.

 */

NONSHARABLE_CLASS( CPdcData ): public CBase

    {

public:    

    /**

    * Symbian 1st phase constructor

    * @return Self pointer to CPdcData pushed to

    * the cleanup stack.

    * @param    aFs file system

    * @param    aContactIds ids of any predefined contacts that

    *                       have been added.

    */

    static CPdcData* NewL( RFs& aFs,  CVPbkContactLinkArray& aLinkArray );

    /**

    * Destructor.

    */

    virtual ~CPdcData();

public:

    /**

    * Checks if the predefined contacts need to be added.

    * @return ETrue if the predefined contacts need to be added

    */

    TBool ContactsUpToDateL(); 

    /**

    * Stores the most recent info about the firmware etc, plus 

    * the ids of any contacts that have been added.

    */

    void StoreL();

    /**

    *  Gets the location of the vCards and XML file

    *  @return  file location

    */

    HBufC* GetFileLocationL();

    /**

     * Gets the buffer of contact links

     * @return  buffer of contact links

     */

    HBufC8* LinkArrayBuffer();

private: // C++ constructor and the Symbian second-phase constructor

    CPdcData( RFs& aFs, CVPbkContactLinkArray& aLinkArray );

    void ConstructL();

private: // private member functions

    void InternalizeL( RReadStream& aStream );

	void ExternalizeL( RWriteStream& aStream ) const;

private: // data

    /// Ref: File system.

    RFs& iFs;

    /// Central repository

    CRepository* iRepository;

    /// Ref: Contacts link array

    CVPbkContactLinkArray& iLinkArray;

    /// Own: Buffer containing list of contact links

    HBufC8* iLinkBuffer;

    };

#endif // C_PDCDATA_H