/*
* Copyright (c) 2009-2010 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:
* Connection method manager server.
*
*/


#ifndef CMMSERVER_H_
#define CMMSERVER_H_

#include <e32base.h>

#include "cmmserverdefs.h"
#include "cmmanagerimpl.h"

class CCmmDelayedShutdown;


/**
 * The main server class
 */
NONSHARABLE_CLASS( CCmmServer ) : public CPolicyServer
    {
public:

    /**
     * Two phased construction.
     */
    static CCmmServer* NewL();

    /**
     * Two phased construction.
     */
    static CCmmServer* NewLC();

    /**
     * Destroy the object and release all memory objects
     */
    ~CCmmServer();

    /**
     * Increments the count of active sessions for this server.
     */
    void IncrementSessions();

    /**
     * Decrements the count of the active sessions for this server.
     * If no more sessions are in use the server terminates.
     */
    void DecrementSessions();

     /**
     * Produces object containers (needed by subsessions) with unique ids within the server.
     * @return A object container.
     */
    CObjectCon* NewContainerL();

    /**
     * Removes from index and deletes the object container.
     * @param aContainer The container to be deleted.
     * @return A object container.
     */
    void RemoveContainer( CObjectCon* aContainer );

    CCmManagerImpl* CmManager();

    /**
     * Check for restrictions for adding an embedded destination from destination
     * instances of all clients.
     * @param aDestinationId The ID of the destination where a destination is
     * beeing embedded.
     * @param aEmbeddedDestinationId The ID of the destination that is beeing
     * embedded.
     */
    TBool EmbeddedDestinationConflictsFromAllSessions(
            const TUint32& aDestinationId,
            const TUint32& aEmbeddedDestinationId );

    /**
     * Notify each session about a destination/connection method that has been
     * updated to, or deleted from, database.
     */
    void RefreshHandlesForAllSessions( const TUint32& aId );
    
    /**
     * Custom security checking for IPCs marked with TSpecialCase::ECustomCheck.
     * @param aMsg The IPC message from the client.
     * @return The result of the security check (TCustomResult::EPass/TCustomResult::EFail).
     */
    TCustomResult CustomSecurityCheckL(
            const RMessage2& aMsg,
            TInt& aAction,
            TSecurityInfo& aMissing );

    /**
     * Checks the client's capabilities in the middle of request handling. Some
     * checks cannot be done with CustomSecurityCheckL() at the start phase of
     * the operation.
     * @param aMsg The IPC message from the client.
     * @return Returns ETrue if client has the needed capabilities. Otherwise
     * returns EFalse.
     */
    CPolicyServer::TCustomResult CapabilityCheckWithProtection( const RMessage2& aMessage );

protected: // From CActive
    /**
     * Process any errors
     *
     * @param aError the leave code reported
     */
    TInt RunError( TInt aError );

private:

    /**
     * Perform the first phase of two phase construction
     *
     * @param Priority for this thread
     */
    CCmmServer( TInt aPriority );

    /**
     * Perform the second phase construction
     */
    void ConstructL() ;

private: // From CServer

    /**
     * Create a time server session, and return a pointer to the
     * created object
     *
     * @param Version
     *
     * @result Pointer to the new session
     */
    CSession2* NewSessionL( const TVersion& aVersion, const RMessage2& aMessage ) const;

private:
    /** The number of client-server sessions */
    TInt iSessionCount;

    static const TUint iCmmRangeCount;
    static const TInt iCmmRanges[];
    static const TUint8 iCmmElementIndex[];

    static const CPolicyServer::TPolicyElement iCmmElements[];
    static const CPolicyServer::TPolicy iCmmPolicy;

    CCmManagerImpl* iCmManager;

    // Object container index
    CObjectConIx* iContainerIndex;

    // Pointer to the shutdown timer object
    CCmmDelayedShutdown* iShutdown;
    };

/**
* CCmmDelayedShutdown
* Shutdown timer that closes Connection Method Manager server after a period.
*/
NONSHARABLE_CLASS( CCmmDelayedShutdown ) : public CActive
    {
public:
    CCmmDelayedShutdown( CCmmServer* aServer );
    void ConstructL();
    ~CCmmDelayedShutdown();

public:
    /**
     * Starts shutdown timer.
     * @return KErrNone if OK, otherwise a system wide error code.
     */
    void Start();

private:
    /**
     * From CActive Cancels the shutdown timer.
     */
    void DoCancel();

    /**
     * From CActive Shuts the server down.
     */
    void RunL();

private: // Data
    RTimer iTimer;
    CCmmServer* iServer;
    };


#endif // CMMSERVER_H_

// End of file