/*

* Copyright (c) 2002-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 CSisxUIOperationWatcher class 

*

*                This class handles the asynchronous install / unsinstall 

*                requests.

*

*/

#ifndef SISXUIOPERATIONWATCHER_H

#define SISXUIOPERATIONWATCHER_H

//  INCLUDES

#include <e32base.h>

#include <SWInstStartupTaskParam.h>

#include <SWInstLogTaskParam.h>

#include "SisxUIHandler.h"

#include "CUICancelTimer.h"

// FORWARD DECLARATIONS

namespace Swi 

{ 

class CInstallPrefs; 

class CAsyncLauncher;

class CSisRegistryPackage;

}

namespace SwiUI

{

// FORWARD DECLARATIONS

class CTaskManager;

class CTask;

class CSisxUIAppInfo;

// CLASS DECLARATION

/**

* This class handles the asynchronous install / unsinstall requests.

*

* @lib sisxui.lib

* @since 3.0

*/

class CSisxUIOperationWatcher : public CActive, 

                                public MSisxUICancelObserver,

                                public CommonUI::MCUICancellable

    {

    public:  // Constructors and destructor

        /**

        * Two-phased constructor.

        */

        static CSisxUIOperationWatcher* NewL();

        /**

        * Destructor.

        */

        virtual ~CSisxUIOperationWatcher();

    public: // New functions

        /**

        * Handle install request.

        * @since 3.0

        */

        void InstallL( RFile& aFile, 

                       const TDesC8& aMIME, 

                       TBool aIsDRM,

                       TRequestStatus& aRequestStatus );

        /**

        * Handle silent install request.

        * @since 3.0

        */

        void SilentInstallL( RFile& aFile, 

                             const TDesC8& aMIME, 

                             TBool aIsDRM,

                             TInstallOptions& aOptions, 

                             TRequestStatus& aRequestStatus );

        /**

        * Handle uninstall request.

        * @since 3.0

        */

        void UninstallL( const TUid& aUid, TRequestStatus& aRequestStatus );

        /**

        * Handle silent uninstall request.

        * @since 3.0

        */

        void SilentUninstallL( const TUid& aUid, 

                               TUninstallOptions& aOptions, 

                               TRequestStatus& aRequestStatus );

        /**

        * Uninstalls only a specific augmentation (sispatch)

        * @since 3.0

        * @param aUid - Uid of the package.

        * @param aIndex - Index of the augmentation.

        */

        void UninstallAugmentationL( const TUid& aUid, TInt aIndex, TRequestStatus& aRequestStatus ); 

        /**

        * Uninstalls only a specific augmentation (sispatch) - silently.

        * @since 3.0

        * @param aUid - Uid of the package.

        * @param aOptions - Options for the silent operation.

        * @param aIndex - Index of the augmentation.

        */

        void SilentUninstallAugmentationL( const TUid& aUid, 

                                           TUninstallOptions& aOptions,

                                           TInt aIndex, 

                                           TRequestStatus& aRequestStatus );         

        /**

        * Informs the UI, about final completion.

        * @since 3.0

        */

        void FinalCompleteL();  

    public: // Functions from base classes

        /**

        * From CActive, Override.

        * @since 3.0

        */

        void Cancel();

        /**

        * From CActive, Called by framework when request is finished.

        * @since 3.0

        */

        void RunL();

        /**

        * From CActive, Called by framework when request is cancelled.

        * @since 3.0

        */        

        void DoCancel();  

        /**

        * From CActive, Handles a leave occurring in the request completion 

        * event handler RunL().

        * @since 3.0

        */

        TInt RunError( TInt aError );

        /**

        * From MSisxUICancelObserver, Called when user has cancelled the operation.

        * @since 3.0

        */  

        void UserCancelL( TBool aCancelImmediately );   

        /**

        * From MCUICancellable, Indicates if a modal dialog is currently shown.

        */

        TBool IsShowingDialog();

        /**

        * From MCUICancellable, Cancels the installation engine.

        */       

        void CancelEngine();

        /**

        * From MCUICancellable, Called when nothing else has worked.

        */               

        void ForceCancel();         

        /**

        * From MCUICancellable, Called to indicate that the cancelling progress 

        * has been started.

        */  

        void StartedCancellingL();         

    private:

        /**

        * Completes the pending request.

        * @param aResult - Result of the request

        */

        void CompleteRequest( TInt aResult );

    private:

        /**

        * C++ default constructor.

        * @param aRequestStatus - Status of the request.

        */

        CSisxUIOperationWatcher();

        /**

        * 2nd phase constructor.

        */

        void ConstructL();

        /**

        * Add files to startup list.

        * @since 3.0

        */

        void AddStartupItemsL( RArray<TStartupTaskParam>& aParams );

        /**

        * Remove files from the startup list.

        * @since 3.0

        */

        void RemoveStartupItemsL( RArray<TStartupTaskParam>& aParams );

        /**

        * Checks if the given uid has installed a startup file. If it finds one

        * it removes it and creates a task to remove the items as well.

        * @since 3.0

        */

        void RemoveStartupFileL( TUid aUid );        

        /**

        * Handles the log entry addition.

        * @since 3.0

        * @param aAppInfo - Package info.

        * @param aAction - Action of the log.

        * @param aIsStartup - Indicates if the startup list was modified.

        */

        void HandleLogL( const CSisxUIAppInfo& aAppInfo, 

                         const TLogTaskAction& aAction, 

                         TBool aIsStartup );   

        /**

        * Helper to handle the case of pip file.

        * @since 3.0

        * @param aPipFileHandle - Handle to pip file.

        * @param aSisFileHandle - On return contains handle to sis file.

        */

        void HandlePipFileL( RFile& aPipFileHandle, RFile& aSisFileHandle );        

        /**

        * Helper to read ocsp values from central repository and prepare the ui.

        * @since 3.0

        * @param aUIHandler - UI handler.

        * @param aPrefs - Engine install preferences.

        */

        void PrepareOCSPL( CSisxUIHandler* aUIHandler, Swi::CInstallPrefs* aPrefs );

        /**

        * Helper to get the packages that were installed in this session.

        * @since 3.0

        * @param aPackages - On return contains the installed packages.

        */

        void GetInstalledPackagesL( RPointerArray<CSisxUIAppInfo>& aPackages );

        /**

        * Helper to handle startup list addition.

        * @since 3.0

        * @param aAppInfo - Installed application.

        */

        void HandleStartupAdditionL( const CSisxUIAppInfo& aAppInfo ); 

        /**

        * Prepares the installation.

        * @since 3.0

        */

        void PrepareInstallL();

        /**

        * Completes the installation

        * @since 3.0

        */

        void CompleteInstallationL();

        /**

        * Completes the uninstallation

        * @since 3.0

        */

        void CompleteUninstallationL();  

        /**

        * Performs the uninstallation of augmentation.

        * @since 3.0

        * @param aUid - Uid of the package.

        * @param aIndex - Index of the augmentation.

        */

        void DoUninstallAugmentationL( TUid aUid, TInt aIndex ); 

        /**

        * Notifies that uninstallation is about to start.

        * @since 3.0

        * @param aUid - Uid of the package to be uninstalled.

        */

        void NotifyStartUninstallL( TUid aUid );

        /**

        * Notifies that uninstallation has been completed.

        * @since 3.0

        */

        void NotifyEndUninstall();   

        /**

        * Handles searching correct manager for DRM registration

        * @since 3.0

        * @param aAgent - content access agent

        * @return Manager - Manages files and content access agents

        */        

        /**

         * Register PIP package content to DRM DCF server.

         * @since 5.0

         * @param aUID - Sis package UID       

         */                        

         void RegisterContentToDCF( TUid aUid );

         /**

          * Search files which should be register to DCF server.

          * @since 5.0

          * @param aSourceArray - Array conteining file paths.

          * @param aTargetArray - Array for files which should be register.     

          */                      

         void SearchFilesForDCFL( 

             RPointerArray<HBufC>& aSourceArray,

             RPointerArray<HBufC>& aTargetArray );        

    private: // Data

        Swi::CAsyncLauncher* iLauncher;        

        CSisxUIHandler* iUIHandler;

        CTaskManager* iTaskManager;        

        TRequestStatus* iRequestStatus;

        RFile iSourceFile;

        HBufC8* iMIME;        

        TUid iUninstalledUid;

        // Pip file related

        RFile iTempFile;  // Points to extracted sis file

        RFs iRfs;        

        TBool iIsPipFile;

        TFileName iTempDir;        

        RPointerArray<HBufC> iInstalledFiles;

        RPointerArray<Swi::CSisRegistryPackage> iAugmentations;        

        TBool iStartupModified; 

        TBool iPreparing;  

        TBool iCancelOngoing;   

        TBool iIsUserCancel;        

        TBool iIsAugmentation;        

        TBool iIsSilent;

        TBool iDoSilentOcsp;        

        CommonUI::CCUICancelTimer* iCanceller;

        RArray<TInt> iSupportedLanguages;

        TBool iDeletionOngoing;

    };

}

#endif      // SISXUIOPERATIONWATCHER_H   

// End of File