/*

* 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 Location Acquisition Strategy

*

*/

#ifndef C_LBTSTRATEGY_H

#define C_LBTSTRATEGY_H

#include "lbtstrategybase.h"

#include "lbtstrategyengineobserver.h"

class CLbtStrategyEngine;

/**

 * CLbtStrategy is an ECom plugin that implements CLbtStrategyBase class. This 

 * class defines a containment for a single instance of CLBtStrategyEngine that

 * is responsible for supervising triggers in the system. Notifications from 

 * CLbtStrategyEngine about firing of triggers, status of trigger supervision 

 * is received and forwarded to location triggering server logic.

 *

 * @since S60 v4.0

 */

NONSHARABLE_CLASS( CLbtStrategy ) : public CLbtStrategyBase,

                                    public MLbtStrategyEngineObsrvr

    {

public:

    /**

     * Factory function that instantiates an object of CLbtStrategy

     *

     * @param aConstructionParameters - 

     */

    static CLbtStrategy* NewL( TAny* aConstructionParameters );

    /**

     * Destructor

     */

    ~CLbtStrategy();

public:     // from base class CLbtStrategyBase

    /**

     * From CLbtStrategyBase

     * Called by Location Triggering Server Logic to issue request to 

     * start supervision

     */

    virtual void StartSupervision();

    /**

     * From CLbtStrategyBase

     * Called by Location Triggering Server Logic to issue request to

     * stop the supervision process. 

     */

    virtual void StopSupervision();

    /**

     * From CLbtStrategyBase

     * Called by Location Triggering Server Logic when settings related to 

     * trigger supervision changes

     */

    virtual void TriggeringSupervisionSettingsChanged();

public:     // from observer class MLbtStrategyEngineObsrvr

    /**

     * From MLbtStrategyEngineObsrvr

     * Called by Strategy Engine to report trigger fire events

     */

    void TriggerFired(CLbtGeoAreaBase::TGeoAreaType aAreaType,TLbtTriggerId aId, const TPositionInfo& aPosInfo );

    /**

     * From MLbtStrategyEngineObsrvr

     * Called by Strategy Engine to report triggering supervision status

     */

    void ReportTriggeringSupervisionStatus( 

                    const TLbtStrategySupervisionDynamicInfo& aDynInfo );

    /**

     * From MLbtStrategyEngineObsrvr

     * Called by Strategy Engine to retrieve triggering settings information

     */

    void RetrieveTriggeringSettings( 

                    TLbtStrategyTriggeringSupervisionSettings& aSettings );

private:

    /**

     * 2nd phase constuctor for instantiating member variables

     *

     * @param aConstructionParameters - 

     */

    void ConstructL( TAny* aConstructionParameters );

    /**

     * Default constructor

     */

    CLbtStrategy();

private:

    /**

     * Ownership of the handle to Strategy Engine is maintained in the 

     * instance of this class

     */

    CLbtStrategyEngine*     iStrategyEngine;

    };

#endif