--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/presencecache/presencecacheclient2/inc/presencecacheclient.h Tue Feb 02 10:12:17 2010 +0200
@@ -0,0 +1,245 @@
+/*
+* Copyright (c) 2007, 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: Implementation for presence cache reader and writer.
+*
+*/
+
+#ifndef PRESENCECACHECLIENT_H
+#define PRESENCECACHECLIENT_H
+
+#include <presencecachereader2.h>
+#include <presencecachewriter2.h>
+
+#include "presencecachedefs2.h"
+
+class MPresenceBuddyInfo2;
+class MPresenceCacheWriteHandler2;
+class MPresenceCacheReadHandler2;
+class CPresenceCacheClientNotification;
+
+//Include Cache server namespace
+using namespace NCacheSrv2;
+
+/**
+ * Implementation for presence cache reader and writer. This object is
+ * instantiated either by MPresenceCacheReader2 or MPresenceCacheWriter2 using ecom framework.
+ * Apart from implementing these two objects, this is also a Symbian OS client and
+ * it communicates with presence cache server. Its also an active object.
+ *
+ * @since S60 v3.2
+ */
+class CPresenceCacheClient : public CActive,
+ public RSessionBase,
+ public MPresenceCacheReader2,
+ public MPresenceCacheWriter2
+
+ {
+public:
+
+ /**
+ * Factory method to instantiate CPresenceCacheClient through the ECom.
+ *
+ * @return The new CPresenceCacheClient object. Object
+ * ownership is returned to caller.
+ */
+ IMPORT_C static CPresenceCacheClient* NewL();
+
+ /**
+ * Factory method to instantiate CPresenceCacheClient through the ECom.
+ * It's returns MPresenceCacheReader2
+ *
+ * @return The new CPresenceCacheClient object. Object
+ * ownership is returned to caller.
+ */
+ IMPORT_C static MPresenceCacheReader2* CreateReaderL();
+
+ /**
+ * Factory method to instantiate CPresenceCacheClient through the ECom.
+ * It's returns MPresenceCacheWriter2
+ *
+ * @return The new CPresenceCacheClient object. Object
+ * ownership is returned to caller.
+ */
+ IMPORT_C static MPresenceCacheWriter2* CreateWriterL();
+
+
+ /**
+ * Public destructor.
+ * Objects can be deleted through this interface.
+ */
+ virtual ~CPresenceCacheClient();
+
+ /**
+ * Start the server
+ * @return TInt Error code
+ */
+ TInt StartServer();
+
+ /**
+ * Version.
+ * Gets the version number.
+ * @return The version.
+ */
+ TVersion Version() const;
+
+
+private:
+
+ /**
+ * C++ constructor
+ */
+ CPresenceCacheClient();
+
+ /**
+ * Symbian second phase constructor
+ */
+ void ConstructL();
+
+ /**
+ * Connect.
+ * Connects to the server and create a session.
+ * @return Error code.
+ */
+ TInt Connect();
+
+ /**
+ * Packs MPresenceBuddyInfo2 object into a buffer
+ *
+ * @param aBuddyPresInfo, MPresenceBuddyInfo2
+ * @return HBufC8* buffer
+ */
+ HBufC8* PackBuddyPresenceInfoLC(const MPresenceBuddyInfo2* aBuddyPresInfo);
+
+ /**
+ * Packs MPresenceBuddyInfo2List object into a buffer
+ *
+ * @param aList, MPresenceBuddyInfo2List
+ * @return HBufC8* buffer
+ */
+ HBufC8* PackPresenceBuddyListLC(const RPointerArray<MPresenceBuddyInfo2>& aList);
+
+
+ /**
+ * Handle asynchronous call from server that buddies presence have been prepared.
+ * This function does further processing and calls the client.
+ *
+ * @param aError, Error came from server.
+ */
+ void HandlePreparedAllBuddiesPresenceL(TInt aError);
+
+ /**
+ * Return true if given identity is valid xsp identity
+ *
+ * @param ETrue if valid xsp identity
+ */
+ TBool ValidateXspId(const TDesC& aXspId);
+
+
+
+public: //From MPresenceCacheReader2
+
+ MPresenceBuddyInfo2* PresenceInfoLC(const TDesC& aIdentity);
+
+ TInt BuddyCountInAllServices();
+
+ TInt BuddyCountInService(const TDesC& aServiceName);
+
+ TInt ServicesCount();
+
+ TInt CancelRead();
+
+ TInt SubscribePresenceBuddyChangeL(const TDesC& aIdentity);
+
+ void UnSubscribePresenceBuddyChangeL(const TDesC& aIdentity);
+
+
+public: //From MPresenceCacheReader2, Asynchronous methods
+
+ TInt AllBuddiesPresenceInService(const TDesC& aServiceName,
+ MPresenceCacheReadHandler2* aHandler);
+
+ TInt SetObserverForSubscribedNotifications(
+ MPresenceCacheReadHandler2* aHandler);
+
+public: //From MPresenceCacheWriter2
+
+ TInt WritePresenceL(const MPresenceBuddyInfo2* aPresenceBuddyInfo);
+
+ TInt DeleteService(const TDesC& aServiceName);
+
+ TInt DeletePresenceL(const TDesC& aIdentity);
+
+ MPresenceBuddyInfo2* NewBuddyPresenceInfoLC();
+
+ // MPresenceBuddyInfoList* NewPresenceBuddyInfoListLC(const TDesC& aServiceName);
+
+ TInt CancelWrite();
+
+
+public: //From MPresenceCacheWriter2, Asynchronous methods
+
+ TInt WriteMultiplePresenceL(const RPointerArray<MPresenceBuddyInfo2>& aPresenceBuddyInfos,
+ MPresenceCacheWriteHandler2* aHandler);
+
+public: //From CActive
+
+ void RunL();
+
+ void DoCancel();
+
+private: // Data
+
+ //Not Owned
+ MPresenceCacheWriteHandler2* iWriteHandler;
+
+ //Not Owned
+ MPresenceCacheReadHandler2* iReadHandler;
+
+ //To store async request status
+ NRequest::TOpAsyncCodes iAsyncReq;
+
+ /**
+ * Client who subscribed cache notifications
+ * NOT OWN
+ */
+ MPresenceCacheReadHandler2* iNotifyClient;
+
+ /**
+ * Handler for subscribed cache notifications
+ * OWN
+ */
+ CPresenceCacheClientNotification* iNotifyHandler;
+
+ /**
+ * Asynchronous data packet
+ * OWN
+ */
+ HBufC8* iPresInfoPack;
+
+ /**
+ * Asynchronous data packet
+ * OWN
+ */
+ HBufC16* iPresInfoPack16;
+
+private: // friend classes
+
+ friend class CPresenceCacheClientNotification;
+
+ };
+
+#endif // PRESENCECACHECLIENT_H
+
+
+