/*
 * Copyright (c) 2008 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:  ?Description
 *
 */

#ifndef CASRVMMCHISTORY_H
#define CASRVMMCHISTORY_H

#include <e32base.h>

// FORWARD DECLARATION

class RFs;

/**
 * MMC History.
 * Stores a fixed number of MMC ids. When new ID-s are inserted,
 * old ones are purged. Supports file persistence.
 */
NONSHARABLE_CLASS( CCaSrvMmcHistory ): public CBase
    {

public:
    // construction

    /**
     * Creates an instance of CCaSrvMmcHistory.
     * @return a pointer to CCaSrvMmcHistory insctance.
     */
    IMPORT_C static CCaSrvMmcHistory* NewL();

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

public:
    // new methods

    /**
     * Load from file. Safe to call if file does not exist.
     * @param aFs File Server Session.
     * @param aFname File name.
     */
    IMPORT_C void LoadL( RFs& aFs, const TDesC& aFname );

    /**
     * Save to file. Existing file overwritten.
     * @param aFs File Server Session.
     * @param aFname File name.
     */
    IMPORT_C void SaveL( RFs& aFs, const TDesC& aFname );

    /**
     * Insert new ID to first position.
     * If ID is already in the history, now it is moved to first
     * position (->latest).
     * If history is full, oldest ID may be dropped from history.
     * @param aMmc MMC ID.
     */
    IMPORT_C void InsertL( TUint aMmc );

    /**
     * Find ID in history.
     * @param aMmc MMC ID.
     * @return History index, or KErrNotFound.
     */
    IMPORT_C TInt Find( TUint aMmc ); // Find mmc in history.

private:
    /**
     * Constructor.
     */
    CCaSrvMmcHistory();

    /**
     * Second phase symbian constructor.
     */
    void ConstructL();

private:
    // data

    RArray<TUint> iMmcList; ///< ID history list. Own.

    };

#endif // CASRVMMCHISTORY_H