--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/ipsservices/ipssosplugin/inc/ipsplgmrulist.h	Thu Dec 17 08:39:21 2009 +0200
@@ -0,0 +1,181 @@
+/*
+* 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: This file defines class CIpsPlgMruList.
+*
+*/
+
+
+#ifndef IPSPLGMRULIST_H
+#define IPSPLGMRULIST_H
+
+
+const TUid KCRUidIpsSosMru = { 0x20010128 };
+
+/**
+ *  Most recent used name and address store
+ *
+ *  Reads and writes most recent used email addresses to central
+ *  repository. Central repository stores key - value -pairs. In this
+ *  case, first 16 bits of a key is used to identify mailbox and last 16
+ *  bits makes key unique for name and address information. Example:
+ *
+ *  Key         Value
+ *  0000 0000   <mailboxId1>                     : integer
+ *  0000 0001   <1. name of mailboxid1>          : descriptor
+ *  0000 0002   <1. email addr of mailboxid1>    : descriptor
+ *  0000 0003   <2. name of mailboxid1>          : descriptor
+ *  0000 0004   <2. email addr of mailbodid1>    : descriptor
+ *  .... ....
+ *  .... ....
+ *  0001 0000   <mailboxId2>                     : integer
+ *  0001 0001   <1. email addr of mailboxid2>    : descriptor
+ *  0001 0002   <1. email addr of mailboxid2>    : descriptor
+ *  .... ....
+ *  .... ....
+ *  FFFF 0000   <mailboxIdFFFF+1>                : integer
+ *  FFFF 0001   <1. email addr of mailboxIdNNNN> : descriptor
+ *  FFFF 0002   <1. email addr of mailboxIdNNNN> : descriptor
+ *
+ *  @lib ipssosplugin.lib
+ *  @since
+ */
+class CIpsPlgMruList : public CBase
+    {
+public:
+    /**
+     * Two-phased constructor.
+     */
+     static CIpsPlgMruList* NewL( );
+
+    /**
+     * Destructor.
+     */
+    virtual ~CIpsPlgMruList();
+
+    /**
+     * Reads last used contacts from centrep and return
+     * array of descriptors that contains data. Data is read
+     * from cache if not changed in centrep. On error situation
+     * return empty descriptor array.
+     *
+     * @param aMailbox unique mailbox id
+     * @return  descriptor array
+     * @since FS 1.0
+     */
+    CDesCArrayFlat* GetMruListL( const TFSMailMsgId& aMailbox );
+
+    /**
+     * Writes last used contacts to centrep.
+     * On error all data consern mailbox is cleared from centrep
+     *
+     * @param aMailbox unique mailbox id
+     * @param aNewMruList contact descriptor array
+     * @since FS 1.0
+     */
+    void SetMruListL( const TFSMailMsgId& aMailBoxId,
+        MDesCArray* aNewMruList );
+
+    /**
+     * Cleares all data stored under mailbox id
+     *
+     * @param aMailbox unique mailbox id
+     * @since FS 1.0
+     */
+    void ClearDataL( const TFSMailMsgId& aMailBoxId );
+
+private:
+
+    /**
+     * Constructor
+     */
+    CIpsPlgMruList( );
+
+    /**
+     * Constructor for leaving methods
+     */
+    void ConstructL( );
+
+    /**
+     * Reads descriptor identified by aKey from centrep
+     *
+     * @param aKey centrep key for descriptor
+     * @return KErrCorrupt or error from centrep transaction
+     */
+    TInt StoreToArrayL(TUint32 aKey);
+
+    /**
+     * Read all mailbox keys from centrep to array
+     * finds key that contains mailboxid
+     *
+     * @param aMboxId mailbox id key to be finded
+     * @param aMboxKey correct key or invalid key if mailbox id not
+     *                 founded from centrep
+     * @param aArray array where all mailbox keys will be stored
+     * @return KErrNone or KErrNotFound
+     */
+    TInt GetMailboxKeyFromRepositoryL(
+        TInt aMboxId,
+        TUint32& aMboxKey,
+        RArray<TUint32>& aArray );
+
+    /**
+     * inline for creating iRepository, for performance reasons
+     * not created in constructl
+     */
+    inline static void CreateRepositoryL( CRepository*& aRep );
+
+    /**
+     * Find smallest key that not founded in array
+     *
+     * @param aKeys set of keys which is sorted in fuction
+     * @return unique key
+     */
+    TUint32 GetUnusedMboxKey( RArray<TUint32>& aKeys );
+
+    /**
+     * Find smallest key that not founded in array
+     *
+     * @param aMboxKey mailbox key which data error conserns
+     * @param aError system wide error code
+     */
+    void HandleRepositoryError( TUint32 aMboxKey, TInt aError );
+
+private: // data
+
+    // Mru list repository instance
+    CRepository*            iRepository;
+
+    // array for repository data
+    RPointerArray<HBufC>    iHbufArray;
+
+    // array for repository keys
+    RArray<TUint32>         iKeys;
+
+    };
+
+
+
+// inline for centrep object creation
+inline void CIpsPlgMruList::CreateRepositoryL( CRepository*& aRep )
+    {
+    if ( !aRep )
+        {
+        // real uid needed
+        aRep = CRepository::NewL( KCRUidIpsSosMru );
+        }
+    }
+
+#endif // IPSPLGMRULIST_H
+
+// End of file