/*
* 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:  CMS Server
*       
*
*/


#ifndef __CMSSERVER_H__
#define __CMSSERVER_H__

// INCLUDES
#include <f32file.h>
#include "cmscommondefines.h"
#include "MCmsPhonebookOperationsObserver.h"

//FORWARD DECLARATIONS
class CCmsPhonebookProxy;
class MPresenceTrafficLights;
class MVPbkContactLink;
class CCmsServerSession;
class CCmsServerContact;
class CCmsPhonebookProxy;
class CRCSEProfileRegistry;

/** 
 * CCmsScheduler is used instead of default active scheduler to
 * make customized handling of leaves in RunL methods of active 
 * objects.
 */
class CCmsScheduler : public CActiveScheduler
    {
    public:  // from base class

        /**
        * Error handling that ignores leaves of
        * active object RunL methods
        */
        void Error( TInt aError ) const;
    };

/**
 * CCmsServer class is responsible for starting the server thread and creating
 * sessions for its clients. 
 */ 
NONSHARABLE_CLASS( CCmsServer ) : public CServer2,
                                  public MCmsPhonebookOperationsObserver                        
    {
    public: // Constructors and destructor
        
        /**
        * Start the server thread
        *
        * @return Error code
        */
        static TInt StartThreadL();

        /**
        * Create a new session
        *
        * @param TVersion The version of the client interface
        * @param RMessage2& Kernel message
        * @return The new session
        */
        CSession2* NewSessionL( const TVersion& aVersion,
        						const RMessage2& /*aMessage*/ ) const;
        
        /**
        * Destructor
        */
        ~CCmsServer();

    private: // Constructors
        
        /**
        * Create the main server object
        *
        * @return Main server object
        */
        static CCmsServer* NewLC();
        
        /**
        * Private default constructor
        * 
        * @param aPriority Active object priority
        */
        CCmsServer( TInt aPriority );
        
        /**
        * The Symbian OS second-phase constructor
        */
        void ConstructL();
    
    public:
        
        /**
        * Return a reference to phonebook proxy
        * 
        * @return Reference to phonebook proxy
        */
        CCmsPhonebookProxy& PhonebookProxyHandle();

        /**
        * Return a reference to file session handle
        *
        * @return File session handle
        */
        RFs& FileSession();
        
        /**
         * Return a reference to RCSE Profile registry.
         * Uses lazy initialization
         * 
         * @return RCSE Profile Registry instance 
         */
        CRCSEProfileRegistry& RCSEProfileRegistryL();
        
    public:  //static
        
        /**
        * Panic the server
        *
        * @param aPanic Panic code
        */
        static void PanicServer( TCmsServerPanic aPanic );
            
    public:  // From MCmsPhonebookOperationsObserver
    
        void StoreOpenComplete();  
        void CmsSingleContactOperationComplete( TInt aError );
    
    private:            // Data
        
        /// Global handler to file server session, available for all
        /// CMS sessions. Owned.
        RFs                                     iFS;

        /// Phonebook proxy which is responsible for common phonebook 
        /// operations. Available for all CMS sessions. Owned.
        CCmsPhonebookProxy*                     iPhonebookProxy;
        
        /// Owned. Shared RCSE Profile registry instance for all sessions.
        /// Constructing this instance is slow and therefore it's kept
        /// in server where it can be quickly aquired.
        CRCSEProfileRegistry*                   iRCSEProfileRegistry;
    };

#endif

// End of File