contentstorage/srvinc/casrvmmchistory.h
author hgs
Fri, 14 May 2010 17:24:44 +0300
changeset 94 dbb8300717f7
parent 85 7feec50967db
permissions -rw-r--r--
201019
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
85
7feec50967db 201003_02
hgs
parents:
diff changeset
     1
/*
7feec50967db 201003_02
hgs
parents:
diff changeset
     2
 * Copyright (c) 2008 Nokia Corporation and/or its subsidiary(-ies).
7feec50967db 201003_02
hgs
parents:
diff changeset
     3
 * All rights reserved.
7feec50967db 201003_02
hgs
parents:
diff changeset
     4
 * This component and the accompanying materials are made available
7feec50967db 201003_02
hgs
parents:
diff changeset
     5
 * under the terms of "Eclipse Public License v1.0"
7feec50967db 201003_02
hgs
parents:
diff changeset
     6
 * which accompanies this distribution, and is available
7feec50967db 201003_02
hgs
parents:
diff changeset
     7
 * at the URL "http://www.eclipse.org/legal/epl-v10.html".
7feec50967db 201003_02
hgs
parents:
diff changeset
     8
 *
7feec50967db 201003_02
hgs
parents:
diff changeset
     9
 * Initial Contributors:
7feec50967db 201003_02
hgs
parents:
diff changeset
    10
 * Nokia Corporation - initial contribution.
7feec50967db 201003_02
hgs
parents:
diff changeset
    11
 *
7feec50967db 201003_02
hgs
parents:
diff changeset
    12
 * Contributors:
7feec50967db 201003_02
hgs
parents:
diff changeset
    13
 *
7feec50967db 201003_02
hgs
parents:
diff changeset
    14
 * Description:  ?Description
7feec50967db 201003_02
hgs
parents:
diff changeset
    15
 *
7feec50967db 201003_02
hgs
parents:
diff changeset
    16
 */
7feec50967db 201003_02
hgs
parents:
diff changeset
    17
7feec50967db 201003_02
hgs
parents:
diff changeset
    18
#ifndef CASRVMMCHISTORY_H
7feec50967db 201003_02
hgs
parents:
diff changeset
    19
#define CASRVMMCHISTORY_H
7feec50967db 201003_02
hgs
parents:
diff changeset
    20
7feec50967db 201003_02
hgs
parents:
diff changeset
    21
#include <e32base.h>
7feec50967db 201003_02
hgs
parents:
diff changeset
    22
7feec50967db 201003_02
hgs
parents:
diff changeset
    23
// FORWARD DECLARATION
7feec50967db 201003_02
hgs
parents:
diff changeset
    24
7feec50967db 201003_02
hgs
parents:
diff changeset
    25
class RFs;
7feec50967db 201003_02
hgs
parents:
diff changeset
    26
7feec50967db 201003_02
hgs
parents:
diff changeset
    27
/**
7feec50967db 201003_02
hgs
parents:
diff changeset
    28
 * MMC History.
7feec50967db 201003_02
hgs
parents:
diff changeset
    29
 * Stores a fixed number of MMC ids. When new ID-s are inserted,
7feec50967db 201003_02
hgs
parents:
diff changeset
    30
 * old ones are purged. Supports file persistence.
7feec50967db 201003_02
hgs
parents:
diff changeset
    31
 */
7feec50967db 201003_02
hgs
parents:
diff changeset
    32
NONSHARABLE_CLASS( CCaSrvMmcHistory ): public CBase
7feec50967db 201003_02
hgs
parents:
diff changeset
    33
    {
7feec50967db 201003_02
hgs
parents:
diff changeset
    34
7feec50967db 201003_02
hgs
parents:
diff changeset
    35
public:
7feec50967db 201003_02
hgs
parents:
diff changeset
    36
    // construction
7feec50967db 201003_02
hgs
parents:
diff changeset
    37
7feec50967db 201003_02
hgs
parents:
diff changeset
    38
    /**
94
hgs
parents: 85
diff changeset
    39
     * Creates an instance of CCaSrvMmcHistory.
hgs
parents: 85
diff changeset
    40
     * @return a pointer to CCaSrvMmcHistory insctance.
hgs
parents: 85
diff changeset
    41
     */
hgs
parents: 85
diff changeset
    42
    IMPORT_C static CCaSrvMmcHistory* NewL();
hgs
parents: 85
diff changeset
    43
hgs
parents: 85
diff changeset
    44
    /**
85
7feec50967db 201003_02
hgs
parents:
diff changeset
    45
     * Destructor.
7feec50967db 201003_02
hgs
parents:
diff changeset
    46
     */
94
hgs
parents: 85
diff changeset
    47
    virtual ~CCaSrvMmcHistory();
85
7feec50967db 201003_02
hgs
parents:
diff changeset
    48
7feec50967db 201003_02
hgs
parents:
diff changeset
    49
public:
7feec50967db 201003_02
hgs
parents:
diff changeset
    50
    // new methods
7feec50967db 201003_02
hgs
parents:
diff changeset
    51
7feec50967db 201003_02
hgs
parents:
diff changeset
    52
    /**
7feec50967db 201003_02
hgs
parents:
diff changeset
    53
     * Load from file. Safe to call if file does not exist.
7feec50967db 201003_02
hgs
parents:
diff changeset
    54
     * @param aFs File Server Session.
7feec50967db 201003_02
hgs
parents:
diff changeset
    55
     * @param aFname File name.
7feec50967db 201003_02
hgs
parents:
diff changeset
    56
     */
7feec50967db 201003_02
hgs
parents:
diff changeset
    57
    IMPORT_C void LoadL( RFs& aFs, const TDesC& aFname );
7feec50967db 201003_02
hgs
parents:
diff changeset
    58
7feec50967db 201003_02
hgs
parents:
diff changeset
    59
    /**
7feec50967db 201003_02
hgs
parents:
diff changeset
    60
     * Save to file. Existing file overwritten.
7feec50967db 201003_02
hgs
parents:
diff changeset
    61
     * @param aFs File Server Session.
7feec50967db 201003_02
hgs
parents:
diff changeset
    62
     * @param aFname File name.
7feec50967db 201003_02
hgs
parents:
diff changeset
    63
     */
7feec50967db 201003_02
hgs
parents:
diff changeset
    64
    IMPORT_C void SaveL( RFs& aFs, const TDesC& aFname );
7feec50967db 201003_02
hgs
parents:
diff changeset
    65
7feec50967db 201003_02
hgs
parents:
diff changeset
    66
    /**
7feec50967db 201003_02
hgs
parents:
diff changeset
    67
     * Insert new ID to first position.
7feec50967db 201003_02
hgs
parents:
diff changeset
    68
     * If ID is already in the history, now it is moved to first
7feec50967db 201003_02
hgs
parents:
diff changeset
    69
     * position (->latest).
7feec50967db 201003_02
hgs
parents:
diff changeset
    70
     * If history is full, oldest ID may be dropped from history.
7feec50967db 201003_02
hgs
parents:
diff changeset
    71
     * @param aMmc MMC ID.
7feec50967db 201003_02
hgs
parents:
diff changeset
    72
     */
7feec50967db 201003_02
hgs
parents:
diff changeset
    73
    IMPORT_C void InsertL( TUint aMmc );
7feec50967db 201003_02
hgs
parents:
diff changeset
    74
7feec50967db 201003_02
hgs
parents:
diff changeset
    75
    /**
7feec50967db 201003_02
hgs
parents:
diff changeset
    76
     * Find ID in history.
7feec50967db 201003_02
hgs
parents:
diff changeset
    77
     * @param aMmc MMC ID.
7feec50967db 201003_02
hgs
parents:
diff changeset
    78
     * @return History index, or KErrNotFound.
7feec50967db 201003_02
hgs
parents:
diff changeset
    79
     */
7feec50967db 201003_02
hgs
parents:
diff changeset
    80
    IMPORT_C TInt Find( TUint aMmc ); // Find mmc in history.
7feec50967db 201003_02
hgs
parents:
diff changeset
    81
7feec50967db 201003_02
hgs
parents:
diff changeset
    82
private:
94
hgs
parents: 85
diff changeset
    83
    /**
hgs
parents: 85
diff changeset
    84
     * Constructor.
hgs
parents: 85
diff changeset
    85
     */
hgs
parents: 85
diff changeset
    86
    CCaSrvMmcHistory();
hgs
parents: 85
diff changeset
    87
hgs
parents: 85
diff changeset
    88
    /**
hgs
parents: 85
diff changeset
    89
     * Second phase symbian constructor.
hgs
parents: 85
diff changeset
    90
     */
hgs
parents: 85
diff changeset
    91
    void ConstructL();
hgs
parents: 85
diff changeset
    92
hgs
parents: 85
diff changeset
    93
private:
85
7feec50967db 201003_02
hgs
parents:
diff changeset
    94
    // data
7feec50967db 201003_02
hgs
parents:
diff changeset
    95
7feec50967db 201003_02
hgs
parents:
diff changeset
    96
    RArray<TUint> iMmcList; ///< ID history list. Own.
7feec50967db 201003_02
hgs
parents:
diff changeset
    97
7feec50967db 201003_02
hgs
parents:
diff changeset
    98
    };
7feec50967db 201003_02
hgs
parents:
diff changeset
    99
7feec50967db 201003_02
hgs
parents:
diff changeset
   100
#endif // CASRVMMCHISTORY_H