/*
* Copyright (c) 2009-2010 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 CIAUpdateFWUpdateHandler;
class CIAUpdateParameters;
class CIAUpdateGlobalLockHandler;
class CIAUpdateAutomaticCheck;
class MIAUpdateNode;
class MIAUpdateFwNode;
class CEikonEnv;
class RCmManager;
class CIdle;
class HbAction;
class IAUpdateResultsDialog;

class IAUpdateEngine : public QObject,
                       public MIAUpdateUiControllerObserver
    {
    Q_OBJECT

public:
    IAUpdateEngine(QObject *parent = 0);
    ~IAUpdateEngine();
    
    void StartedByLauncherL( bool 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, 
                                bool aForcedRefresh );

     /**
      * 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, uint aUid );
     
     
     void StartUpdate( bool aFirmwareUpdate );
     /**
      * Set this application visible/unvisible
      * @param aVisible If EFalse application is put background and is hidden in FSW 
      */
      void SetVisibleL( bool aVisible );
      
      /**
      * Set window group id of client application 
      *
      * @param aWgId Window group id
      */
      void SetClientWgId( int aWgId );
          
      /**
      * Is client application in background
      *
      * @param True value if client application is in background
      */
      bool ClientInBackgroundL() const;
    
signals:
    void toMainView();
    
    /**
    * Refreshes main view 
    * @param aError  Error code
    */              
    void refresh(const RPointerArray<MIAUpdateNode>& nodes,
                 const RPointerArray<MIAUpdateFwNode>& fwNodes,
                 int error);
    

public slots:    
    void handleAllClientsClosed();    

    void dialogFinished(HbAction* action);
  

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 UI to be redrawn during update process
    *
    * @param aError Error code
    */
    void RefreshUI();
            
    /**
    * 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

    /**
    * Show results dialog of update
    */ 
    void ShowResultsDialogL();
    
    
    void ShowRebootDialogL();
           
    /**
    * Informs an observer that its async request is completed 
    *
    * @param aError  Error code 
    */ 
    void InformRequestObserver( int 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( bool aTotalSilent );   
    
     /**
     * Choose a usable IAP from all SNAPs
     *
     * @param aCmManager handle of connection manager
     */  
    uint GetBestIAPInAllSNAPsL( RCmManager& aCmManager );
        
     /**
     * Choose a usable IAP from Internet SNAP
     *
     * @param aCmManager handle of connection manager
     */
    uint GetBestIAPInInternetSNAPL( RCmManager& aCmManager );

     /**
     * Choose the best IAP under the given SNAP
     *
     * @param aCmManager handle of connection manager
     * @param aSNAP SNAP ID
     */  
     uint GetBestIAPInThisSNAPL( RCmManager& aCmManager, uint aSNAP = 0);
     
     /**
     * Shows update query dialog (now/later) 
     */ 
     void ShowUpdateQueryL();

     void HideApplicationInFSWL( bool 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 );
     
     /**
     * CIdle callback function, that performs automatic update check and query
     *
     * @param aPtr  Pointer to this instance
     */
     static TInt AutomaticCheckCallbackL( TAny* aPtr );
     
     bool DoPossibleApplicationClose();
 
   

private:
     
    enum DialogState
        {
        NoDialog,
        Results,
        RebootQuery,
        ShowUpdateQuery
        };
     
    IAUpdateServiceProvider *mServiceProvider;
    IAUpdateResultsDialog* mResultsDialog;
    
    CIAUpdateUiController* iController;
    CIAUpdateFWUpdateHandler* iFwUpdateHandler;
    CIAUpdateGlobalLockHandler* iGlobalLockHandler;
    CIAUpdateAutomaticCheck* iAutomaticCheck;
    CEikonEnv* iEikEnv; //not owned
    CIdle* iIdle;
    CIdle* iIdleAutCheck;
    
    
    IAUpdateUiDefines::TIAUpdateUiRequestType mRequestType;
    bool mUpdateNow;
    RArray<TUint32> iDestIdArray;
    bool mRequestIssued;
    bool mStartedFromApplication;
    bool mUiRefreshAllowed;
    uint mUpdatequeryUid;
    int mWgId;
    DialogState mDialogState;
    HbAction *mPrimaryAction;
    HbAction *mSecondaryAction;
    };

#endif /* IAUPDATEENGINE_H_ */