/*
* 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 "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:  Header file DHCP PSY requester class.
*
*/



#ifndef DHCPPSYREQUESTER_H
#define DHCPPSYREQUESTER_H

//  INCLUDES
#include <e32base.h>
#include <lbspositioninfo.h>

#include "dhcppsyrequesterprogressobserver.h"

// FORWARD DECLARATIONS
class CDhcpPsyPositioner;
class CPositioner;
class CDhcpWlanQueryHandler;

// CLASS DECLARATION


/**
*  This class implements the position requester.
*
*  Position requester is responsible for loading appropriate PSY vi ECom Plug-in
*  and forward location request to the loaded PSY.
*
*  This class may owns an instance of CPositioner.
*
*  @lib dhcppositionprovider.dll
*  @since 3.2
*/
class CDhcpPsyRequester : public CBase, MDhcpPsyRequesterProgressObserver
    {
    public:  // Constructors and destructor

        /**
        * Two - phased constructor.
        *
        */
        static CDhcpPsyRequester* NewL ();

        /**
        * Destructor.
        */
        virtual ~CDhcpPsyRequester();

    public:

        /**
        * Notify position update
        * @param aPosInfo Reference to TPositionerInfoBase, used to store
        *                 fix information.
        * @param aStatus  Reference to TRequestStatus, used to complete location
        *                 request.
        * @since 3.2
        */
        void NotifyPositionUpdate ( TPositionInfoBase& aPosInfo,
            TRequestStatus& aStatus );

        /**
         * Cancel ongoing location query.
         */
        void CancelRequest ();

    protected:

        void  ProgressPsyRequestNotificationL (TRequestProgressPhases aPhase,
            TInt aPhaseValue);

    private:

        enum TDhcpRequesterStates
            {
            EDhpWlanIdle,
            EDchpQueryInitalising,
            EDhcpLocationQueryInProgress
            };

    private:

        /**
        * C++default constructor.
        */
        CDhcpPsyRequester ();

        /**
        * By default Symbian 2nd phase constructor is private.
        */
        void ConstructL();

        /**
        * Make location request to the first PSY
        */
        void MakeLocationRequest();

        /**
        * Complete location request
        */
        void CompleteRequest( TInt aErr );

        /**
        * Free all reserved memory
        */
        void Flush();

    private:    // Methods

        /**
        *
        * Fetch position generic data from input to make location query
        * to the wlan network.
        *
        * @param aPosInfo Reference to TPositionerInfoBase, used to store
        *                 fix information.
        *
        * @return TInt  Status code.
        *
        * @since 3.2
        */
        TInt FetchPositioningGenericData  ( TPositionInfoBase& aPosInfo );

    private:    // Data
        // States
        TDhcpRequesterStates    iQueryState;

        // Internet access point id
        TUint32 iIAPProfileId;

        //
        CDhcpWlanQueryHandler* iWlanDhcpQuery;

        // Pointer to position info
        TPositionInfoBase* iPositionInfo;

        // Status to notify the LF
        TRequestStatus* iRequestStatus;

        // To hold location data until module deleted or
        // new request is made.
        HBufC8* iLocationData;

        //
        TBool iCancelled;

    };

#endif      // DHCPPSYREQUESTER_H

// End of File