/*
* 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:    Session part of the client/server paradigm.*
*/




#ifndef __CCRSESSION_H
#define __CCRSESSION_H

//  INCLUDES
#include <e32base.h>

// CONSTANTS
// None.

// MACROS
// None.

// DATA TYPES
enum TCRPanic
    {
    ECRPanicServiceHandle,
    ECRPanicBadDescriptor,
    ECRPanicInvalidRequestType,
    ECRPanicRequestAsyncTwice,
    ECRPanicBadSubSessionHandle,
    ECRPanicZeroLengthDes,
    ECRPanicDesLengthNegative,
    ECRPanicNullPtrArray,
    ECRPanicNullHandle,
    ECRPanicHandleNotOpen,
    ECRPanicIndexOutOfRange,
    ECRPanicHandleNotClosed,
    ECRPanicBadRequest,
    ECRPanicPanicBadName
    };

// FORWARD DECLARATIONS
class CCREngine;
class CCRServer;

// CLASS DECLARATION

/**
*  CCRSession is the server side session that client applications 
*  talk with. This merely passes commands to CCREngine
*
*  @lib CommonRecordingEngine.lib
*  @since Series 60 3.0
*/
class CCRSession : public CSession2
    {

public: // Constructors and destructor
    
    /**
    * Two-phased constructor.
    * @Param aClient reference client thread
    * @Param aServer pointer to Server
    * @return CCRSession pointer to CCRSession class
    */
    static CCRSession* NewL( CCRServer* aServer );
    
    /**
    * Destructor.
    */
    virtual ~CCRSession();

public: // New methods   
    
    /**
    * Server.
    * @since Series 60 3.0
    * @return a pointer to server.
    */
    inline CCRServer* Server() const
        { 
        return REINTERPRET_CAST( CCRServer*, 
               CONST_CAST( CServer2*, CSession2::Server() ) );
        }

    /**
    * Service.
    * @since Series 60 3.0
    * @param aMessage contains data from the client.
    * @return None.
    */
    void ServiceL( const RMessage2& aMessage );
    
private: // New methods   

    /**
    * Dispatch message.
    * @since Series 60 3.0
    * @param aMessage contains data from the client.
    * @return None.
    */
    void DispatchMessageL( const RMessage2& aMessage );
    
    /**
    * New Object.
    * @since Series 60 3.0
    * @param aMessage contains data from the client.
    * @return None.
    */
    void NewObjectL( const RMessage2& aMessage );
    
    /**
    * Deletes object, can't fail - can panic client.
    * @since Series 60 3.0
    * @param aHandle handle.
    * @return None.
    */
    void DeleteObject( TUint aHandle );
    
    /**
    * Counts resources
    * @return Number of resources
    */
    TInt CountResources();

    /**
    * Panics client.
    * @since Series 60 3.0
    * @param aPanic panic code.
    * @return None.
    */
    void PanicClient( TInt aPanic ) const;
    
private: // Constructors and destructor

    /**
    * C++ default constructor.
    * @Param aClient reference client thread.
    */
    CCRSession();
    
    /**
    * Symbian 2nd phase constructor.
    * @Param aServer pointer to Server.
    */
    void ConstructL( CCRServer* aServer );

private: // Data
    
    /**
    * Object index for this session.
    */
    CObjectIx* iObjects;

    /**
    * Total number of resources allocated.
    */
    TInt iResourceCount;
    
    };

#endif // __CCRSESSION_H

//  End of File