/*

* 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:  This is a wrapper class of Central Repository, responsible

*               for the operations that need to access the central respository.

*

*

*/

#ifndef CCENREPHANDLER_H

#define CCENREPHANDLER_H

// System includes

#include <e32base.h>

// Constants

const TInt KBufferLength = 20;

const TInt KStreamBufferSize = 100;

// Forward declarations

class CRepository;

class TPreset;

class CCenrepBookKeeping;

// Class declaration

/**

 *  it is a wrapper of Central Repository, responsible for the operations that need to access

 *  the central respository.

 */

class CCenrepHandler : public CBase

    {

public:

    /**

    * Two-phased class constructor.

    */

    static CCenrepHandler* NewL();

    /**

    * Destructor of CCenrepHandler class.

    */

    virtual ~CCenrepHandler();

    /**

    * Get the maximum number of presets.

    * @return The maximum number of presets.

    */

    TInt MaxPresetCount() const;

    /**

    * Get the current number of presets.

    * @return The number of presets.

    */

    TInt PresetCount() const;

    /**

    * Get the index of first preset.

    * @return The first preset index.

    */        

    TInt FirstPreset() const;

    /**

    * Get the index of the next preset.

    * @param aFromIndex -  Start from index after this.

    * @return the next preset index.

    */           

    TInt NextPreset( TInt aFromIndex ) const;

    /**

    * Delete the specified preset.

    * Specifying aIndex < 0, will delete all presets.

    * Has no effect if specified index contains no preset.

    */

    TInt DeletePreset( TInt aIndex );

    /**

    * Save the preset.

    * @param aPreset Preset object.

    * @param aIndex -  Preset index.

    * @return given/allocated(in case given value was -1) index.

    */           

    TInt SavePresetL( const TPreset& aPreset, TInt aIndex = -1 );

    /**

    * Read a preset.

    * @param aIndex -  Preset index.

    * @param aPreset Preset object to where to update the data.

    * @return none

    */           

    void ReadPresetL( TInt aIndex, TPreset& aPreset );

private:

    /**

    * Default class constructor.

    */

    CCenrepHandler();

    /**

    * Second phase class constructor.

    */

    void ConstructL();

    /**

    * Read bookkeeping information from the permanent storage.

    */

    void ReadBookKeepingL();

    /**

    * Save bookkeeping information to the permanent storage.

    */

    void SaveBookKeeping();

    /**

    * Read preconfigured presets from the permanent storage.

    */

    void ReadPreDefinedPresetsL();

private: // data

    // Central Repository

    CRepository*        iCentralRepository;

    // Bookkeeping of existing presets

    CCenrepBookKeeping* iBookKeeping;

    };

#endif  // CCENREPHANDLER_H