--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/cbs/CbsServer/ServerInc/CCbsServer.h Tue Feb 02 01:11:09 2010 +0200
@@ -0,0 +1,256 @@
+/*
+* Copyright (c) 2003 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 contains the header file of the CCbsServer class
+*
+* Represents CBS Server. Derives from EPOC client-server framework base
+* class CServer.
+*
+*/
+
+
+
+
+#ifndef CCBSSERVER_H
+#define CCBSSERVER_H
+
+// INCLUDES
+#include <e32base.h>
+#include "CbsCommon.h"
+#include "MCbsDbTopicListObserver.H"
+
+// CONSTANTS
+// This is the priority of the server active object.
+const TInt KCbsServerPriority = CActive::EPriorityStandard;
+
+// FORWARD DECLARATIONS
+#ifdef __WINS__
+// Required to satify EPOCEXE target type build criteria
+IMPORT_C TInt WinsMain( TAny * );
+#endif
+
+class CObjectConIx;
+class CCbsDbImp;
+class CCbsRecEtel;
+class CCbsReceiverHelper;
+class CCbsObject;
+class CCbsSatRefresh;
+class CCbsShutdownMonitor;
+
+// CLASS DECLARATION
+
+/**
+* CCbsServer is the core part of CBS Server.
+*
+* CCbsServer allocates all server-side resources on startup and
+* creates CCbsSession objects in response to client requests.
+*/
+class CCbsServer : public CServer2
+ {
+ public: // New functions
+ /**
+ * Creates an instance of the class.
+ *
+ * The name of the server will be KCbsServerName as specified
+ * in CbsServerConstants.h.
+ *
+ * After the call is made, the server is responsible of releasing
+ * both database and receiver during destruction.
+ *
+ * @return The method returns a pointer to the
+ * new CCbsServer object.
+ */
+ static CCbsServer* NewL();
+
+ /**
+ * Destructor.
+ */
+ ~CCbsServer();
+
+ /**
+ * Creates a new session object container.
+ *
+ * It is the responsibility of the caller to delete the object
+ * container, when it is no longer used.
+ *
+ * @return A pointer to the new object container.
+ */
+ CObjectCon* NewContainerL();
+
+ /**
+ * Returns a reference to the database.
+ *
+ * @return Database object
+ */
+ CCbsDbImp& Database();
+
+ /**
+ * Returns a reference to the receiver.
+ *
+ * @return Receiver object
+ */
+ CCbsRecEtel& Receiver();
+
+ /**
+ * Returns the total number of detected (via topic detection feature)
+ * topics and then clears the counter.
+ *
+ * @return Number of detected topics.
+ */
+ TInt TotalTopicsDetected();
+
+ /**
+ * Panics the client.
+ *
+ * @param Reason of panic
+ */
+ void PanicClient( TInt aPanic ) const;
+
+ /**
+ * Shuts the server down.
+ */
+ void Shutdown();
+
+ /**
+ * Returns the object container index reference
+ *
+ * @return Container index reference
+ */
+ CObjectConIx& ContainerIndex();
+
+ /**
+ * Returns the current message
+ *
+ * @return Current IPC message
+ */
+ const RMessage2 ServerMessage() const;
+
+ /**
+ * Returns an object by handle.
+ *
+ * @param aHandle Handle to the object.
+ * @return Pointer to the object or, if there is no
+ * such object, NULL.
+ */
+ CCbsObject* ReturnObjectByHandle( TUint aHandle );
+
+ /**
+ * Deletes a subsession
+ *
+ * @param aHandle Handle to the object.
+ */
+ void DeleteObjectByHandle( TUint aHandle );
+
+ /**
+ * Returns the object container
+ *
+ * @@return The object container
+ */
+ CObjectCon& Container();
+
+ /**
+ * Returns the object index
+ *
+ * @@return The object index
+ */
+ CObjectIx& ObjectIx();
+
+ /**
+ * Reloads the SIM topics in case of SAT/SIM refresh
+ *
+ */
+ void ReLoadSimTopicsL();
+
+ public: // From CServer2
+
+ /**
+ * Creates a new session (an instance of CCbsSession).
+ *
+ * The method is meant to be called by the Symbian OS server framework and
+ * so it should not be used in any other case.
+ *
+ * The method leaves if the version given as parameter and the server
+ * version differ.
+ *
+ * @param aVersion Expected version of CBS Server.
+ * @return New session object.
+ */
+ CSession2* NewSessionL( const TVersion& aVersion, const RMessage2& aMessage ) const;
+
+ private:
+
+ /**
+ * Constructor.
+ *
+ * @param aPriority Priority of the server.
+ */
+ CCbsServer( TInt aPriority );
+
+ /**
+ * Finalizes the construction by creating subcomponents
+ * and synchronizing DB and receiver states.
+ */
+ void ConstructL();
+
+ /**
+ * Initializes the receiver
+ */
+ void InitReceiverL();
+
+ /**
+ * Initializes topic detection status.
+ */
+ void InitTopicDetectionStatusL();
+
+ private: // Prohibited operators and functions
+
+ // Copy constructor
+ CCbsServer( const CCbsServer& );
+
+ // Assignment operator
+ CCbsServer& operator=( const CCbsServer& );
+
+ private: // Data
+
+ // Own: The container index, that is required to create
+ // object containers.
+ CObjectConIx* iContainerIx;
+
+ // Own: database object.
+ CCbsDbImp* iDatabase;
+
+ // Own: receiver object.
+ CCbsRecEtel* iReceiver;
+
+ // Own: gateway to the receiver.
+ CCbsReceiverHelper* iHelper;
+
+ // Own: PubSub shutdown monitor
+ CCbsShutdownMonitor* iShutdownMonitor;
+
+ // Own: the object container that contains the subsessions.
+ CObjectCon* iContainer;
+
+ // Own: object index that is used to find a subsession object
+ // by it's handle.
+ CObjectIx* iIndex;
+
+ // Sat refresh listener
+ CCbsSatRefresh* iSatRefresh;
+ };
+
+#endif // CCBSSERVER_H
+
+// End of File
+
+