/*
* 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 CPOSITIONREQUEST_H
#define CPOSITIONREQUEST_H

// INCLUDE FILES
#include <e32base.h>
#include "epos_proxypositionerconstructparams.h"

// CONSTANT DECLARATIONS

// FORWARD DECLARATIONS
class CPositioner;
class CPosPositionLog;
class CPosModuleSettings;
struct TPosModulesEvent;
class CPosCallbackTimer;
class CPosLocMonitorReqHandlerHub;

// CLASS DECLARATION

/**
*    Active object implementing a position request cycle. Handles
*    activities such as controlling logging and verifying privacy.
*
*/
class CPositionRequest : public CActive
    {
    public:  // Constructors and destructor
    	static CPositionRequest* NewL(CPosModuleSettings& aModuleSettings,
    			CPosLocMonitorReqHandlerHub& aLastPositionHandler,
    			TProxyPositionerConstructParams& aPositionerParams,
    			TBool aIsProxy);
        virtual ~CPositionRequest();

    public:  // New functions
        void MakeRequestL(const RMessage2& aMessage);
        void SetUpdateOptions(const TPositionUpdateOptionsBase& aOptions);
        void GetUpdateOptions(TPositionUpdateOptionsBase& aOptions) const;
        void NewTrackingSessionIfTracking();
        void HandleSettingsChangeL(TPosModulesEvent aEvent);
        void NotifyServerShutdown();
        void ExtendUpdateTimeOut(const TTimeIntervalMicroSeconds& aAdditionalTime);

    protected:  // From CActive

        void RunL();
        TInt RunError(TInt aError);
        void DoCancel();

    private:
        CPositionRequest(CPosModuleSettings& aModuleSettings,
        		CPosLocMonitorReqHandlerHub&    aLastPositionHandler,
        		TProxyPositionerConstructParams& aPositionerParams,
        		TBool aIsProxy);

        void ConstructL();
        CPositionRequest( const CPositionRequest& );
        CPositionRequest& operator= ( const CPositionRequest& );

        void CompleteRequest(TInt aReason);
        void CompleteClient(TInt aReason);
        void CompleteSelf(TInt aReason);

        void StartPositionDataRequestPhase();
        void StartTrackingTimerWaitPhase();

        TInt PackPositionData();
        void SaveAsLastKnownPosition();

        static TInt HandleTimeOut(TAny* aPositionRequest);
        static TInt TrackingCallback(TAny* aPositionRequest);

        void HandleTrackingStateL();
        void RestartTrackingL();
        void StopTracking();
        void ContinueTrackingTimer();

        void StartPsyTrackingL();
        void StopPsyTracking();

        void LoadPositionerL();

    private:  // Data

        enum TPosRequestStage
            {
            EPosReqInactive = 0,
            EPosReqPositionRequest,
            EPosWaitForTracking
            };

        enum TPosTrackingState
            {
            EPosNoTracking = 0,         /** No tracking is ongoing */
            EPosFirstTrackingRequest,   /** This request completes immediately
                                            Next will be delayed by interval */
            EPosTracking,               /** Internal and PSYs timers started */
            EPosStopTracking            /** Tracking marked to stop */
            };

        RMessage2                   	iMessage;
    	HBufC8*                     	iPositionBuffer;
        TPosRequestStage            	iRequestPhase;
        TInt                        	iRequestId;
        CPositioner*                	iPositioner; 
        TPositionModuleInfo         	iModuleInfo;
        TProxyPositionerConstructParams  iPositionerParams;
        TBool                       	iHasProxyPositioner;

        TTime                       	iReqStartTime;        
        CPosCallbackTimer*          	iTimeoutTimer;
        TTimeIntervalMicroSeconds   	iTimeOut;
        TBool                       	iRequestTimedOut;

        TBool                       	iPositionerTrackingStarted;
        TPosTrackingState           	iTrackingState;
        CPosCallbackTimer*          	iTrackingTimer;
        TTimeIntervalMicroSeconds  	 	iTrackingUpdateInterval;
        TBool                       	iTrackingOverridden;
        const RRequestorStack*      	iTrackingRequestorStackPtr;
        TBool                       	iNewTrackingInterval;

//        CPosLocMonitorReqHandlerHub&    iLastPositionHandler;
        CPosLocMonitorReqHandlerHub&    iLocMonitorReqHandler;
        CPosModuleSettings&         	iModuleSettings;
        TUid	                        iPosStatusCategory;
    };  

#endif  // CPOSITIONREQUEST_H

// End of File