/*

* Copyright (c) 2006, 2007 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:  Class definition of Status Manager

*

*/

#ifndef C_LBTLOCATIONREQUESTOR_H

#define C_LBTLOCATIONREQUESTOR_H

#include <lbs.h>

#include "lbtpsychangeobserver.h"

// FORWARD DECLARATIONS

class CLbtPsyChangeListner;

/**

 * This class defines the methods used by CLbtStrategyEngine to acquire 

 * location information. This is a wrapper class that establishes a session

 * to location server to obtain location information.

 */

NONSHARABLE_CLASS( CLbtLocationRequestor ) : public CBase,

											 public MLbtPsyChangeObserver

	{

public: // Methods

    /**

     * Factory function that instantiates an object of CLbtLocationRequestor

     *

     * @param aPosID - Identifies the module to be used by location server to 

     *                 obtain location information

     */

	static CLbtLocationRequestor* NewL(  );

    /**

     * Destructor

     */

	~CLbtLocationRequestor();

    /**

     * Requests location information from location server

     *

     * @param aPosInfo - Holds the current position of the device

     * @param aStatus - Holds the result of the asynchronous request

     * @aPosID - Identifies the module to be used by location server to obtain

     *           location information

     */

	void CurrentLocation( TPositionInfo& aPosInfo, 

	                        TRequestStatus& aStatus, TPositionModuleId aPosID,

	                        TTimeIntervalMicroSeconds aTimeOut );

	/**

	 * Request location information from NPP Psy

	 */

	void CurrentLocationFromNpp( TPositionInfo& aPosInfo, 

	                             TRequestStatus& aStatus,

                                 TTimeIntervalMicroSeconds aTimeOut );

	/**

	 * Retrieves information about the positioning technology being used

	 */

	void GetModuleInfo( TPositionModuleId aPosID );

	/**

	 * Retrieves position module Id used to get location information

	 */

	TPositionModuleId GetPositionModuleId();

	/**

	 * Determines if GPS method is used to retrieve location information

	 */

	TBool GPSUsed() const;

    /**

     * Cancels an outstanding request for obtaining location information

     */

    void Cancel();

    /**

     * Cancels an outstanding request for obtaining location information from NPP PSY

     */

    void CancelFixFromNpp();

private:

    /**

     * Default constructor

     */

	CLbtLocationRequestor();

    /**

     * 2nd phase constuctor for instantiating member variables     

     * @param aPosID - Identifies the module to be used by location server to 

     *                 obtain location information

     */

	void ConstructL( );

    /**

     * Checks for changes 

     * @param aPosID - Identifies the module to be used by location server to 

     *                 obtain location information

     */

	void OpenConnectionL( TPositionModuleId aPosID );

private: // from MLbtPsyChangeObserver

	void HandlePsyChangeEvent( TPositionModuleId aModuleId );

private:

	/**

	 * Handle to the location server interface

	 */

	RPositionServer	    iPosServer;

	/**

	 * Handle to create a subsession with the location sever

	 */

	RPositioner		    iPositioner;

	/**

	 * Handle to NPP psy

	 */

	RPositioner         iNppPositioner;

	/**

	 * Identifies the module to be used by location server to obtain location 

	 * information

	 */

	TPositionModuleId   iPosID;

	/**

	 * Identifier to determine if GPS method is being used to obtain location

	 * information

	 */

	TBool               iGPSUsed;

	/**

	 * Identifier to determine if the handle to NPP psy is valid

	 */

	TBool              iValidNppHandle;

	/**

	 * Object to listen to PSY Changes if NBP is not enabled

	 */

	CLbtPsyChangeListner*		iNbpChangeListener;

	};

#endif	// C_LBTLOCATIONREQUESTOR_H