/*

* 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 Engine

*

*/

#ifndef C_LBTSTRATEGYENGINE_H

#define C_LBTSTRATEGYENGINE_H

#include <etelmm.h>

#include "lbtstrategy.h"

#include "lbttriggerview.h"	

#include "lbttriggerchangeobserver.h"

#include "lbtcoordinatesupervisor.h"

#include "lbtcellsupervisor.h"

class MLbtStrategyEngineObsrvr;

class CLbtCellChangeHandler;

/**

 * CLbtStrategyEngine is responsible for supervising triggers in the system. 

 * The instance of CLbtStrategyEngine acquires the terminal's location 

 * information using the instance of CLbtLocationRequestor and supervises 

 * triggers. It notifies location triggering server logic component when 

 * triggers are fired. 

 *

 * @since S60 v4.0

 */

NONSHARABLE_CLASS( CLbtStrategyEngine ) : public MLbtContainerChangeEventObserver,

                                          public MLbtTriggerViewObserver

    {

public:     // Methods

    /**

     * Factory function that instantiates an object of CLbtStrategyEngine

     *

     * @param aConstructionParameters - 

     */

    static CLbtStrategyEngine* NewL( TAny* aConstructionParameters, 

                                        MLbtStrategyEngineObsrvr* aObserver );

    /**

     * Destructor

     */

    ~CLbtStrategyEngine();

public:

    /**

     * Called by CLbtStrategy to issue request to start supervision

     */

    void StartSupervision();

    /**

     * Called by CLbtStrategy to issue request to stop the supervision process

     */

    void StopSupervision();

    /**

     * Called by CLbtStrategy when settings related to trigger supervision 

     * changes

     */

    void SettingsChanged();

public:     // from interface class MTriggerViewObserver

    /**

     * From MTriggerViewObserver

     * Called by CLbtTriggerView when the view is refreshed after a new 

     * position fix is provided or after trigger modifications are

     * notified by the Container

     */

    virtual void OperationComplete( 

                            MLbtTriggerViewObserver::TOperation aOperation );

public:     // from interface class MLbtContainerChangeEventObserver

    /**

     * From MLbtContainerChangeEventObserver

     * Called by Location Triggering Container when trigger(s) is / are 

     * modified or created

     *

     * @param aTriggerIds - ID(s) of the trigger(s) that was/were created or 

     * modified

     */

    virtual void TriggerStoreChanged( RArray<TLbtTriggerId>& aTriggerIds,

                                      TLbtTriggerEventMask aEventMask,

                                      TLbtContainerChangedAreaType aAreaType,

                                      RArray<TUid>& aManagerUids );

private:

	 void ConstructL( TAny* aConstructionParameters,

                                        MLbtStrategyEngineObsrvr* aObserver );

	CLbtStrategyEngine();

	/**

     * Initialises Etel.

     */

    void InitialiseEtelL();

private:

	CLbtTriggerView*				            iView;

	CLbtCoOrdinateSupervisor*                   iCoOrdinateSupervisor;

	CLbtCellSupervisor*                         iCellSupervisor;

	TBool                                       iSupervisionInitiated;

	TBool                                       iViewInitialised;

	MLbtContainerChangeEventObserver::TLbtContainerChangedAreaType iChangedAreaType;

	RTelServer 			                        iTelServer; 

    RMobilePhone 		                        iMPhone; 

    CLbtCellChangeHandler*                      iCellChangeHandler;

	};

#endif	// C_LBTSTRATEGYENGINE_H