--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/dvrengine/CommonRecordingEngineClient/inc/CCRServerHandleSingleton.h Wed Sep 01 12:20:37 2010 +0100
@@ -0,0 +1,125 @@
+/*
+* 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 the License "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: Singleton to hold server session*
+*/
+
+
+
+
+#ifndef CCRSERVERHADLESINGLETON_H
+#define CCRSERVERHADLESINGLETON_H
+
+// INCLUDES
+#include "RCRService.h"
+#include "RCRClient.h"
+#include <e32base.h>
+
+// CONSTANTS
+// None
+
+// MACROS
+// None
+
+// DATA TYPES
+// None
+
+// FORWARD DECLARATIONS
+class CCRAPIBase;
+
+// CLASS DECLARATION
+
+/**
+* Singleton class to store client handles. Instance of this class is kept
+* in TLS and a reference count is maintained. This is to ensure that if a
+* process creates multiple CCRDvrApi instances, they will all share the
+* same session to CommonRecordingEngine.
+*
+* @lib CommonRecordingEngineClient.lib
+* @since Series 60 3.0
+*/
+NONSHARABLE_CLASS( CCRServerHandleSingleton ) : public CBase
+ {
+
+ /**
+ * CCRApiBase and CCRDvrApi are the only classes
+ * that should have access to this class.
+ */
+ friend class CCRApiBase;
+ friend class CCRDvrApi;
+
+private: // Constructors and destructors
+
+ /**
+ * Private constructor to prevent direct instantiation. InstanceL must be used.
+ */
+ CCRServerHandleSingleton();
+
+ /**
+ * Second phase of 2-phased construction
+ */
+ void ConstructL();
+
+ /**
+ * Private destructor to prevent direct deletion. Release must be used.
+ */
+ ~CCRServerHandleSingleton();
+
+private: // New methods
+
+ /**
+ * Returns the singleton instance. If it does not yet exist, it is created.
+ * If it does, a reference count is incremented
+ * @since Series 60 3.0
+ * @param none.
+ * @return Instance to singleton class.
+ */
+ static CCRServerHandleSingleton* InstanceL();
+
+ /**
+ * Releases the singleton instance. If reference count reaches zero, the
+ * instance is destroyed and client connection closed.
+ */
+ static void Release();
+
+ /**
+ * Returns a reference to the service handle
+ * @since Series 60 3.0
+ * @param none.
+ * @return Reference to RCRService
+ */
+ inline RCRService& Service() { return iService; }
+
+private: // Data
+
+ /**
+ * Amount of references to this instance.
+ * Instance will be deleted when this reaches zero.
+ */
+ TInt iReferenceCount;
+
+ /**
+ * Handle to Recording Engine client.
+ */
+ RCRClient iClient;
+
+ /**
+ * Handle to Recording Engine services.
+ */
+ RCRService iService;
+
+ };
+
+#endif // CCRSERVERHADLESINGLETON_H
+
+// End of File