/*
 * Copyright (c) 2007-2010 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:  Object for accessing most recent used email addresses and
 * display names.
 *
 */

#ifndef EMAILMRU_H_
#define EMAILMRU_H_

#include <QString>
#include "emailutilitiesdef.h"

class XQSettingsManager;


/*!
     Key to MRU repository
 */
static const qint32 emailMruRepositoryKey = 0x2003EA97;

/*!
     Where to find the cenrep-index of the newest saved entry
 */
static const qint32 currentIndexKey = 0;

/*!
     Where to find the number of entries
 */
static const qint32 countKey = 1;

/*!
     Key to contacts central repository
 */
static const qint32 contactsRepositoryKey = 0x2002FF54;

/*!
     Setting for name ordering.
 */
static const qint32 nameOrderKey = 0x1;

/*!
     How many entries are kept in MRU repository
 */
static const qint32 emailAddressHistorySize = 300;

class EMAIL_UTILITIES_EXPORT EmailMRU
{
public:

    EmailMRU();

    ~EmailMRU();

    bool updateMRU(QString displayName, QString emailAddress);

    quint32 entryCount() const;

    bool getEntry(qint32 entryIndex, QString &displayName, QString &address);

    void reset();

    static int nameOrder();

private:

    quint32 getNextEntryIndex();

    bool writeCenRep(qint32 index, QString value);

    QString readCenRep(qint32 index);

    qint32 searchForAddress(QString address);

    static qint32 entryIndex(qint32 crKey);

    static qint32 addressKeyByEntryIndex(qint32 entryIndex);

    static qint32 nameKeyByEntryIndex(qint32 entryIndex);

    void moveEntry(qint32 oldEntryIndex, qint32 newEntryIndex);

    bool writeEntry(qint32 entryIndex, QString displayName, QString emailAddress);

    bool updateEntry(qint32 entryIndex, QString newDisplayName);

private:

    /*!
        Points to the latest saved entry
     */
    qint32 mLatestIndex;

    /*!
        Pointer to central repository manager
     */
    XQSettingsManager* mRepositoryManager;

    /*!
        Number of entries
     */
    quint32 mCount;

};


#endif // EMAILMRU_H_