diff -r 000000000000 -r e686773b3f54 presencecache/presencecacheserver2/inc/presencecachebuddystore.h
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/presencecache/presencecacheserver2/inc/presencecachebuddystore.h	Tue Feb 02 10:12:17 2010 +0200
@@ -0,0 +1,210 @@
+/*
+* 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:  Store object for single buddy in a service
+*
+*/
+
+#ifndef CPPRESENCECACHEBUDDYSTORE_H
+#define CPPRESENCECACHEBUDDYSTORE_H
+
+#include <e32base.h>
+
+class MPresenceBuddyInfo2;
+class CPresenceCacheSession;
+class CPresenceCacheServiceStore;
+
+/**
+ * CPresenceCacheBuddyStore. Used in Presence cache for presence storage. The 
+ * identity part is always exists in this class, subscribers and presence info
+ * are not guaranteed. However, if this object doesn't contain any subscribers 
+ * or presence info, it doesnt serve its purpose and should be deleted.
+ *
+ * @lib presencecacheserver.exe
+ * @since S60 v3.2
+ */
+class CPresenceCacheBuddyStore: public CBase
+    {
+
+public:
+
+    /**
+     * Symbian constructors and c++ destructor
+     *
+     * @param aServiceStore a parent store for this object
+     * @param aIdentity identity for this object, must be in xsp format
+     */
+    IMPORT_C static CPresenceCacheBuddyStore* NewLC(
+                                    CPresenceCacheServiceStore* aServiceStore,
+                                    const TDesC& aIdentity);
+    IMPORT_C static CPresenceCacheBuddyStore* NewL(
+                                    CPresenceCacheServiceStore* aServiceStore,
+                                    const TDesC& aIdentity);
+    virtual ~CPresenceCacheBuddyStore();
+
+private:
+
+    /**
+     * c++ constructor
+     *
+     * @param aServiceStore Parent service store for this object
+     */
+    CPresenceCacheBuddyStore(CPresenceCacheServiceStore* aServiceStore);
+    
+    /**
+     * Symbian second phase constructor
+     * @param aIdentity, uses this identity if not NULL, otherwise creates new
+     */
+    void ConstructL(const TDesC& aIdentity);
+
+
+public: 
+
+    /**
+    * Service name of this object, taken from xsp prefix of the indentity
+    *
+    * @return TPtrC service name of this object
+    */
+    TPtrC ServiceName() const;
+    
+    /**
+    * Sets the presnece info to this object. Takes ownership. It deletes
+    * any old presence info. Calling this function multiple times with
+    * different presence infos doesnt harm.
+    *
+    * @param aPresBuddyInfo buddy presence info to be set to this object
+    */
+    void SetPresenceBuddyInfo(MPresenceBuddyInfo2* aPresBuddyInfo);
+    
+    /**
+    * Removes presence info from this object and set it to NULL.
+    */
+    void RemovePresenceBuddyInfo();
+    
+    /**
+    * Get the subscribed sessions pointer array. The array contains all those
+    * sessions which are currently subscribed to receive changes in this object.
+    *
+    * @return reference to RPointerArray<CPresenceCacheSession>
+    */
+    RPointerArray<CPresenceCacheSession>& GetSubscribedSessions();
+    
+    /**
+    * Add session to the list of subscribed sessions. It does not take ownership.
+    * ignores if session is already there.
+    *
+    * @param aSession to add in subscribed list
+    */
+    void AddSubscribedSession(CPresenceCacheSession* aSession);
+    
+    /**
+    * Remove session to the list of subscribed sessions. It does not take ownership.
+    * ignores if session is not found.
+    *
+    * @param aSession to remove from subscribed list
+    */
+    void RemoveSubscribedSession(CPresenceCacheSession* aSession);
+
+    /**
+    * TODO: Allocates new momery? Or takes ownership?
+    * Sets the identity to this object. Takes ownership. It deletes
+    * any old identity if present. Identity must be in xsp format.
+    *
+    * @param aIdentity identity to be set to this object
+    */
+    void SetBuddyIdL(const TDesC& aIdentity);
+                                
+    /**
+    * Gets presence info from this object.
+    *
+    * @return pointer to MPresenceBuddyInfo2
+    */
+    MPresenceBuddyInfo2* PresenceBuddyInfo() const;
+    
+    /**
+    * Gets identity from this object.
+    *
+    * @return identity
+    */
+    TPtrC BuddyId() const;
+    
+    /**
+    * Matches this object's identity with that of given object. Return True if
+    * matches.
+    *
+    * @param aOtherInstance other CPresenceCacheBuddyStore
+    * @return ETrue if identity matches.
+    */
+    TBool EqualsIdentity(
+                    const CPresenceCacheBuddyStore* aOtherInstance ) const;
+                    
+    /**
+    * Matches this object's identity with that of given object. Return True if
+    * matches.
+    *
+    * @param aOtherInstance MPresenceBuddyInfo2 object
+    * @return ETrue if identity matches.
+    */
+    TBool EqualsIdentity(
+                        const MPresenceBuddyInfo2* aOtherInstance ) const;
+                    
+    /**
+    * Matches this object's identity with that of given identity. Return True if
+    * matches.
+    *
+    * @param aOtherIdentity other identity object
+    * @return ETrue if identity matches.
+    */
+    TBool CPresenceCacheBuddyStore::EqualsIdentity(
+                            const TDesC& aOtherIdentity ) const;
+                    
+    /**
+    * Finds whether this object has any presence info.
+    *
+    * @return ETrue if this object contains any presence info.
+    */
+    TBool HasPresence() const;
+    
+    /**
+    * Finds whether this object has any subscribers.
+    *
+    * @return ETrue if this object has any subscriber(s).
+    */
+    TBool HasSubscribers() const;          
+
+private: // data
+
+     /**
+     * OWN: Contains presence info or NULL
+     */
+    MPresenceBuddyInfo2* iPresenceBuddyInfo;
+
+    /**
+     * OWN: identity
+     */
+    HBufC* iIdentity;
+
+    /**
+    *OWN: Sessions which  are subscribed to receive change in this buddy's presence
+    */
+    RPointerArray<CPresenceCacheSession> iSubscribedSessions;
+    
+    /**
+    *Not Owned: Pointer to this object's service store
+    */
+    CPresenceCacheServiceStore* iServiceStore;
+    
+    };
+
+
+#endif // CPPRESENCECACHEBUDDYSTORE_H