/*

* Copyright (c) 2005-2009 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:

*

*/

#ifndef CPOSSUBSESSION_H

#define CPOSSUBSESSION_H

// INCLUDES

#include <e32base.h>

#include <lbs.h>

#include <lbs/lbsadmin.h>

#include "EPos_MPosParameterObserver.h"

#include "lbsnetinternalapi.h" // for RLbsNetworkRegistrationStatus

#include "lbsnetregstatusint.h" // for RLbsNetworkRegistrationStatus

// CONSTANTS

// FORWARD DECLARATIONS

struct TPosModulesEvent;

class CPosModuleSettings;

class CPositioner;

class CPositionRequest;

class MPosStatusObserver;

class MPosModuleStatusManager;

class CPosLocMonitorReqHandlerHub;

// TODO Verify

class CPosLastPositionAreaRequest;

// TODO to be removed - included to compile code before completion of 

// location monitor

// CLASS DECLARATION

/**

* This class provides functionality common to all EPos subsessions.

*/

class CPosSubSession : public CObject, public MPosParameterObserver

    {

	public:  // Constructor & Destructor

        static CPosSubSession* NewLC(

        			CPosModuleSettings& aModuleSettings,

        			CPosLocMonitorReqHandlerHub& aLocMonitorReqHandlerHub,

        			TUid aImplementationUid,

        			TBool aIsProxy,

        			MPosStatusObserver* aStatusObserver,

        			MPosModuleStatusManager* aModuleStatusManager);

		virtual ~CPosSubSession();

	public:		// New functions

        void ServiceL(const RMessage2& aMessage);

        void HandleSettingsChangeL(TPosModulesEvent aEvent);

        void NotifyServerShutdown();

    protected:  // Functions from MPosParameterObserver

        TInt GetRequiredPositionQuality(TPositionQuality& aPositionQuality) const;

        void GetMaxAge(TTime& aMaxAge) const;

        TBool IsPartialUpdateAllowed() const;

        virtual void GetUpdateTimeOut(TTimeIntervalMicroSeconds& aUpdateTimeOut) const;

        virtual void SetPsyDefaultUpdateTimeOut(const TTimeIntervalMicroSeconds& aUpdateTimeOut);

        virtual void ExtendUpdateTimeOut(const TTimeIntervalMicroSeconds& aAdditionalTime);

    private:

        CPosSubSession();

        void ConstructL(

            CPosModuleSettings& aModuleSettings,

            CPosLocMonitorReqHandlerHub& aLocMonitorReqHandlerHub,

            TPositionModuleId aImplementationUid,

            MPosStatusObserver* aStatusObserver,

            MPosModuleStatusManager* aModuleStatusManager,

            TBool aIsProxy);

        CPosSubSession( const CPosSubSession& );

        CPosSubSession& operator= ( const CPosSubSession& );

        void HandleSetRequestorL(const RMessage2& aMessage);

        void HandleSetRequestorStackL(const RMessage2& aMessage);

		void HandleSetUpdateOptionsL(const RMessage2& aMessage);

		void HandleGetUpdateOptionsL(const RMessage2& aMessage);

		void HandleGetLastKnownPositionL(const RMessage2& aMessage);

		void HandleNotifyPositionUpdateL(const RMessage2& aMessage);

		void HandleGetLastKnownPositionAreaL(const RMessage2& aMessage);   		// TODO Verify

        void HandleNotifyPositionUpdateCancelL(const RMessage2& aMessage);

        void HandleGetLastKnownPositionCancelL(const RMessage2& aMessage);

        void HandleGetLastKnownPositionAreaCancelL(const RMessage2& aMessage); 	// TODO Verify

        void HandleCancelAsyncRequestL(const RMessage2& aMessage);

        void ReadModuleInfoL();        

        void ValidateRequestorL(CRequestor* aRequestor);

        void RequestComplete(const RMessage2& aMessage, TInt aCompleteCode);

        TBool IsSelfLocateEnabled();

    private:    // Data	

    	RRequestorStack             iRequestors;

        CPositionRequest*           iPositionRequest;        

        TBool                       iWaitingForFirstTrackingRequest;

        TTimeIntervalMicroSeconds   iMaxUpdateAge;

        TUid                        iImplementationUid;

        TUint32                     iClassesSupported;

        TBool                       iAcceptPartialUpdates;

        TBool                       iTracking;

        CPosLocMonitorReqHandlerHub*    iLocMonitorReqHandlerHub;

        TTimeIntervalMicroSeconds	iUpdateTimeOut;

        TTimeIntervalMicroSeconds	iPsyDefaultUpdateTimeOut;

        TBool 						iLocationManagementSupported;    

        CLbsAdmin*                  iAdmin;

    	/** internal interface used to broadcast the network registration (roaming) status */

    	RLbsNetworkRegistrationStatus	iNetRegStatus;        

    };

#endif  // CPOSSUBSESSION_H

// End of File