/*
* Copyright (c) 2002 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 is the definition for CDosSession class.
*
*/


#ifndef __DOSSESSION_H__
#define __DOSSESSION_H__

#include "dosserver.h"

class CDosService;

/**
* This class represents a server side session.
*/
NONSHARABLE_CLASS( CDosSession ) : public CSession2
{
public:
	/**
	* Constructor.
	*/
	CDosSession();

	/**
	* Destructor.
	*/
	~CDosSession();

	/**
	* 2nd phase constructor called by the CServer framework.
	*/
	void CreateL();

private:
	/**
	* Returns the server that owns the session.
	* @return A reference to the server.
	*/
	inline CDosServer& Server() const;

	/**
	* This function is called by the CServer framework and handles
	* the requests. It just passes them to DispatchMessageL and complete them
	* if they are auto-completeable
	* @param aMessage Client-server message containing the request.
	*/
	void ServiceL(const RMessage2& aMessage);

	/**
	* Sends the request to the proper handler based on the message function.
	* @param aMessage Client-server message containing the request.
	* @return Symbina error code.
	*/
	TInt DispatchMessageL(const RMessage2& aMessage);

	/**
	* Gets a service object using a handle.
	* @param aHandle Handle assigned to the service by the Server framework,
	* @return A pointer to the Service object.
	*/
	inline CDosService* ServiceFromHandle(const TInt aHandle) const;

	/**
	* Sets up a subsession. Assigns it a handle.
	* @param aHandle Handle assigned to the service by the Server framework,
	* @param aService The Service object.
	*/
	void SetupSubSessionL(const RMessage2& aMessage,CDosService* aService);

	/**
	* Closes a subsession.
	* @param aHandle Handle assigned to the service by the Server framework,
	*/
	void CloseSubSession(const RMessage2& aMessage);
	
private:
	friend class CDosServer;

private:
	//A container for Services.
	CObjectCon* iServiceCon;

	//An index for services.
	CObjectIx* iServices;
	TInt iSDCounter;
};

#include "dossession.inl"


#endif //__DOSSESSION_H__