/*

* Copyright (c) 2002-2004 Nokia Corporation and/or its subsidiary(-ies).

* All rights reserved.

* This component and the accompanying materials are made available

* under the terms of the License "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:  Supports user interaction dialogs for downloads

*

*/

#ifndef CDOWNLOADMGRUIUSERINTERACTIONS_H

#define CDOWNLOADMGRUIUSERINTERACTIONS_H

//  INCLUDES

#include <CDownloadMgrUiBase.h>

#include <DownloadMgrClient.h>

#include <vwsdef.h>

// CONSTANTS

_LIT8( KDrmInnerContentTypesToLaunch, "application/java-archive application/x-java-archive x-epoc/x-sisx-app application/x-pip" );

_LIT8( KSisxApplication, "x-epoc/x-sisx-app application/vnd.symbian.install x-epoc/x-app268436505" );

_LIT8( KPipApplication, "application/x-pip" );

_LIT8( KWidgetMimeType, "application/x-nokia-widget" );

_LIT8( KSharingConfig, "application/isf.sharing.config" );

// DATA TYPES

enum TClientAppExitType

    {

    ETerminatedByUser,

    ETerminatedBySystem

    };

// FORWARD DECLARATIONS

class CUserInteractionsUtils;

class CDownloadMgrUiLibRegistry;

class CAsyncEventHandlerArray;

class CEikAppUi;

class CUserInteractionsExtension;

// CLASS DECLARATION

/**

*  The User Interactions supports the followings:

*  - User confirmation when content-type header arrives

*  - Handling completed downloads

*  - Querying HTTP authentication credentials

*  - Querying proxy authentication credentials

*  - Error notification

*  - Client App termination by the User

*

*  @lib Download Manager UI Lib

*  @since Series 60 2.8

*/

NONSHARABLE_CLASS( CDownloadMgrUiUserInteractions ) : 

                                                public CDownloadMgrUiBase,

                                                public MHttpDownloadMgrObserver

    {

    public:  // Constructors and destructor

        /**

        * Two-phased constructor.

        */

        static CDownloadMgrUiUserInteractions* NewL

               ( CDownloadMgrUiLibRegistry& aRegistryModel );

        /**

        * Destructor.

        */

        virtual ~CDownloadMgrUiUserInteractions();

    public: // New functions

        /**

        * Client Apps can call this function before exiting the application. 

        * It should be called when the user terminates the application. 

        * It opens a confirmation query.

        * @return OK to exit? True/False. It is only a suggested value!

        */

        IMPORT_C TBool OkToExitL();

        /**

        * Client Apps can call this function in the App UI's destructor. 

        * It has been made non-leavable, so it can be called without TRAP.

        * It initializes Grouped Soft Notifications, if necessary.

        * @param aAppUi Reference to the actual App UI.

        * @param aExitType Exit type when this function is called.

        *                  Only ETerminatedBySystem is supported.

        * @param aViewId View ID of the view where to switch in case user chooses

        *                accept softkey in the soft notification.

        * @param aCustomMessageId Custom message ID.

        * @param aViewActivationMsg Custom message sent to the view in 

        *                           the view activation process.

        * @return Error code or KErrNone.

        */

        IMPORT_C TInt PrepareToExit( CEikAppUi& aAppUi, 

                                     TClientAppExitType aExitType, 

                                     TVwsViewId aViewId, 

                                     TUid aCustomMessageId, 

                                     const TDesC8& aViewActivationMsg );

        /**

        * Client Apps can call this function in the App UI's destructor. 

        * It has been made non-leavable, so it can be called without TRAP.

        * It initializes Grouped Soft Notifications, if necessary.

        * @param aAppUid 3rd UID of the application.

        * @param aViewId View ID that needs to be activated.

        * @param aCustomMessageId Custom message ID.

        * @return Error code or KErrNone.

        */

        IMPORT_C TInt PrepareToExit( TUint32 aAppUid,

                                     TUint32 aViewId, 

                                     TUint32 aCustomMessageId );

        /**

        * Currently it supports handling completed download.

        * COD download is deleted, otherwise normal behaviour, that 

        * depends on EDlAttrAction (EDoNothing/EMove/ELaunch).

        * @param aDownload The actual download

        * @return -

        */

        IMPORT_C void HandleDownloadL( RHttpDownload& aDownload );

        /**

        * The number of download confirmations being shown.

        * @return Non-negative integer value.

        */

        TInt DownloadConfirmationsShown() const;

        /**

        * Ask if a handler or something uses the UI, so 

        * others should postpone their tasks that require UI.

        * @return yes/no.

        */

        TBool IsUiBusy() const;

        /**

        * Is a Cod ServiceFlow running?

        * @return yes/no.

        */

        TBool IsCodServiceFlowRunning() const;

        /**

        * Is Cod ServiceFlow running of the given download?

        * @param aDownload The download in question.

        * @return yes/no.

        */

        TBool IsCodServiceFlowRunning( RHttpDownload& aDownload ) const;

        /**

        * Is a Cod ServiceFlow running?

        * LEAVing version.

        * @return yes/no.

        */

        TBool IsCodServiceFlowRunningL() const;

        /**

        * Is Cod ServiceFlow running of the given download?

        * LEAVing version.

        * @param aDownload The download in question.

        * @return yes/no.

        */

        TBool IsCodServiceFlowRunningL( RHttpDownload& aDownload ) const;

        /**

        * Postpone handling the given COD download. The download is placed to a 

        * LIFO queue, and SetHandlerRunning( EFalse ) handles (restarts) the first 

        * download in it.

        * @param aDownload The download to be postponed.

        */

        void PostponeCodHandlingL( RHttpDownload& aDownload );

        /**

        * Check if the given download is postponed.

        * @param aDownload The download in question.

        * @return true/false.

        */

        TBool IsPostponed( RHttpDownload& aDownload ) const;

        /**

        * Schedule a postponed download for running.

        */

        void SchedulePostponedDownloadL();

    public: // Functions from CDownloadMgrUiBase

        /// Attribute enumerations.

        enum TDownloadMgrUiUserInteractionsAttr

            {

            EAttrSuppressDownloadConfirmation ///< TBool, default: EFalse

            };

        IMPORT_C virtual void GetIntAttributeL( const TUint aAttribute, TInt32& aValue );

        IMPORT_C virtual void GetBoolAttributeL( const TUint aAttribute, TBool& aValue );

        IMPORT_C virtual void GetStringAttributeL( const TUint aAttribute, TDes16& aValue  );

        IMPORT_C virtual void GetStringAttributeL( const TUint aAttribute, TDes8& aValue  );

        IMPORT_C virtual void SetIntAttributeL( const TUint aAttribute, TInt32 aValue );

        IMPORT_C virtual void SetBoolAttributeL( const TUint aAttribute, TBool aValue );

        IMPORT_C virtual void SetStringAttributeL( const TUint aAttribute, const TDesC16& aValue );

        IMPORT_C virtual void SetStringAttributeL( const TUint aAttribute, const TDesC8& aValue );

    protected: // Constructors

        /**

        * C++ default constructor.

        */

        CDownloadMgrUiUserInteractions( CDownloadMgrUiLibRegistry& aRegistryModel );

        /**

        * By default Symbian 2nd phase constructor is private.

        */

        void ConstructL();

    protected: // New functions

        // Event handler functions

        /**

        * Wraps DoHandleCompletionWithQueryL() to ensure that only one instance

        * of the dialog is displayed at any point in time.

        * @param aDownload The actual download

        * @return void

        */

        void HandleCompletionWithQueryL( RHttpDownload& aDownload, 

                                                                 TBool aIsUiBusy, 

                                                                 TBool aIsSupported, 

                                                                 TBool aIsDrm, 

                                                                 TBool aDrmRightsOnPhone );

        /**

        * Handle download completion with query (wait) dialog.

        * @param aDownload The actual download

        * @return -

        */

        void DoHandleCompletionWithQueryL( RHttpDownload& aDownload, 

                                                                 TBool aIsUiBusy, 

                                                                 TBool aIsSupported, 

                                                                 TBool aIsDrm, 

                                                                 TBool aDrmRightsOnPhone );

        /**

        * Leaving version of PrepareToExit().

        * @return None.

        */

        void PrepareToExitL( CEikAppUi* aAppUi, 

                             TClientAppExitType aExitType, 

                             TVwsViewId aViewId, 

                             TUid aCustomMessageId, 

                             const TDesC8& aViewActivationMsg );

        /**

        * Is a stand-alone instance running from the very same application?

        * @return True/False.

        */

        TBool IsStandAloneAppRunning();

        /**

        * Delete Event Handler(s) showing download confirmation query.

        * @param aDownload The actual download.

        */

        void DeleteEventHandlerShowingDlConfirmation( RHttpDownload& aDownload );

        /**

        * Delete Event Handler(s) belonging to the given download.

        * @param aDownload The actual download.

        */

        void DeleteEventHandlers( RHttpDownload& aDownload );

        /**

        * Handle completed normal download (not COD or OMA, not DRM).

        * @param aDownload The actual download

        * @return -

        */

        void HandleNormalDownloadL( RHttpDownload& aDownload );

        /**

        * Check if the download is COD.

        * @param aDownload The actual download

        * @return ETrue/EFalse

        */

        TBool CodDownloadL( RHttpDownload& aDownload ) const;

    protected: // Functions from MHttpDownloadMgrObserver

        virtual void HandleDMgrEventL( RHttpDownload& aDownload, 

                                       THttpDownloadEvent aEvent );

    private:  // Data

        CUserInteractionsExtension* iExtension; ///< Extension class, Owned.

        CUserInteractionsUtils*     iUiUtils; /**< Owned. Should be only one 

                                                   instance in the UILib! */

        CAsyncEventHandlerArray*    iEventHandlerArray; ///< Owned.

        TBool                       iDlgActive;

    private: // Friend classes

        friend class CUserInteractionsExtension;

    };

#endif /* CDOWNLOADMGRUIUSERINTERACTIONS_H */