/*

* Copyright (c) 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:   This file contains the header file of the IAUpdateEngine

*                class 

*

*/

#ifndef IAUPDATEENGINE_H_

#define IAUPDATEENGINE_H_

#include <QObject>

#include "iaupdateuidefines.h"

#include "iaupdateuicontrollerobserver.h"

#include "iaupdatenode.h"

class IAUpdateServiceProvider;

class CIAUpdateUiController;

class CIAUpdateParameters;

class CIAUpdateGlobalLockHandler;

class MIAUpdateNode;

class MIAUpdateFwNode;

class CEikonEnv;

class RCmManagerExt;

class CIdle;

class IAUpdateEngine : public QObject,

                       public MIAUpdateUiControllerObserver

    {

    Q_OBJECT

public:

    IAUpdateEngine(QObject *parent = 0);

    virtual ~IAUpdateEngine();

    void StartedByLauncherL( TBool aRefreshFromNetworkDenied );

     /**

      * When the update check operation is started through

      * the API, the session directs the requests for the UI. UI will

      * handle the operation and inform the observer when the operation is

      * completed.

      * @param aFilterParams These parameters are used when update items

      * are filtered for the UI list.

      */

     void CheckUpdatesRequestL( int wgid, CIAUpdateParameters* aFilterParams );

     /**

      * When the show update operation is started through

      * the API, the session directs the requests for the UI. UI will

      * hanle the operation and inform the observer when the operation is

      * completed.

      * @param aFilterParams These parameters are used when update items

      * are filtered for the UI list.

      */

     void ShowUpdatesRequestL( int wgid, CIAUpdateParameters* aFilterParams );

     /** 

      * When the update operation is started through

      * the API, the session directs the requests for the UI. UI will

      * hanle the operation and inform the observer when the operation is

      * completed.

      * @param aUid  Uid of the caller of the request

      */

     void ShowUpdateQueryRequestL( int wgid, TUint aUid );

     /**

      * Set this application visible/unvisible

      * @param aVisible If EFalse application is put background and is hidden in FSW 

      */

      void SetVisibleL( TBool aVisible );

      /**

      * Set window group id of client application 

      *

      * @param aWgId Window group id

      */

      void SetClientWgId( TInt aWgId );

      /**

      * Is client application in backround

      *

      * @param True value if client application is in background

      */

      TInt ClientInBackgroundL() const;

      //void refresh(int error);

signals:

    void toMainView();

    /**

    * Refreshes main view 

    * @param aError  Error code

    */              

    void refresh(const RPointerArray<MIAUpdateNode>& nodes,

                 const RPointerArray<MIAUpdateFwNode>& fwNodes,

                 int error);

    void toHistoryView();

public slots:    

    void handleAllClientsClosed();    

private: // From MIAUpdateUiControllerObserver   

    /**

    * Called when async engine start-up is completed

    *

    * @param aError Error code

    */

    void StartupComplete( TInt aError ); 

    /**

    * Leaving method, called as trapped in StartupComplete

    */

    void StartupCompleteL(); 

    /**

    * Handles leave error. 

    *

    * @param aError Error code

    */      

    void HandleLeaveErrorL( TInt aError );

    /**

    * Handles leave error withot leaving

    *

    * @param aError Error code

    */      

    void HandleLeaveErrorWithoutLeave( TInt aError );

    /**

    * Called when async update list refresh is completed

    *

    * @param aError Error code

    */

    void RefreshCompleteL( TBool aWithViewActivation, TInt aError );

    /**

    * Called when async updating is completed

    *

    * @param aError Error code

    */     

    void UpdateCompleteL( TInt aError );

private:  //new methods

    /**

    * Informs an observer that its async request is completed 

    *

    * @param aError  Error code 

    */ 

    void InformRequestObserver( TInt aError );

    /**

     * Sets the default connection method used for network access.

     * Connection can be set as an accesspoint or as a snap for example.

     *

     * @param aTotalSilent Set to ETrue if want silent connection

     *

     * @note Not stored persistently. A client needs to set this 

     * again every time it creates the controller.

     *

     * @note Leaves with KErrNotFound if connection method was not

     * set in the repocitory.

     */

    void SetDefaultConnectionMethodL( TBool aTotalSilent );   

     /**

     * Choose a usable IAP from all SNAPs

     *

     * @param aCmManagerExt handle of connection manager

     */  

    TUint32 GetBestIAPInAllSNAPsL( RCmManagerExt& aCmManagerExt  );

     /**

     * Choose a usable IAP from Internet SNAP

     *

     * @param aCmManagerExt handle of connection manager

     */

    TUint32 GetBestIAPInInternetSNAPL( RCmManagerExt& aCmManagerExt  );

     /**

     * Choose the best IAP under the given SNAP

     *

     * @param aCmManagerExt handle of connection manager

     * @param aSNAP SNAP ID

     */  

     TUint32 GetBestIAPInThisSNAPL( RCmManagerExt& aCmManagerExt, TUint32 aSNAP = 0);

     /**

     * Shows update query dialog (now/later) 

     */ 

     void ShowUpdateQueryL();

     void HideApplicationInFSWL( TBool aHide ) const;

     /**

     * CIdle callback function, that shows update query dialog

     * To be used because a client to be informed immediately that its 

     * async request is issued. Waiting dialog cannot be shown before responding to a client  

     *

     * @param aPtr  Pointer to this instance

     */

     static TInt UpdateQueryCallbackL( TAny* aPtr );

public: //temp

//private:

    IAUpdateServiceProvider *mServiceProvider;

private:

    CIAUpdateUiController* iController;

    CIAUpdateGlobalLockHandler* iGlobalLockHandler;

    CEikonEnv* iEikEnv; //not owned

    CIdle* iIdle;

    IAUpdateUiDefines::TIAUpdateUiRequestType iRequestType;

    TBool iUpdateNow;

    RArray<TUint32> iDestIdArray;

    TBool iRequestIssued;

    TBool iStartedFromApplication;

    TUint iUpdatequeryUid;

    TInt iWgId;

    };

#endif /* IAUPDATEENGINE_H_ */