/*

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

*

*/

#ifndef SWINSTSESSION_H

#define SWINSTSESSION_H

//  INCLUDES

#include <AknServerApp.h>

#include <SWInstDefs.h>

#include "SWInstRequestObject.h"

#include "CUICancelTimer.h"

namespace SwiUI

{

// FORWARD DECLARATIONS

class CSWInstRequestStore;

class CSWInstServer;

class MRequestCallback;

// CLASS DECLARATION

/**

* This class represents the main server session.

*

* @since 3.0

*/

class CSWInstSession : public CAknAppServiceBase, public MRequestCallback,

                       public CommonUI::MCUICancellable

    {

    public:  // Constructors and destructor

        /**

        * C++ default constructor.

        */

        CSWInstSession();

        /**

        * Destructor.

        */

        virtual ~CSWInstSession();

    public: // New functions

        /**

        * Prepare the session for exit.

        * @since 3.0

        * @param aExitCallback - Will be called when the session is ready for exit.

        */

        void PrepareForExit( MRequestCallback* aExitCallback );       

    public: // Functions from base classes

        /**

        * From CAknAppServiceBase, Handles the received message.

        * The method simply calls HandleRequestL under trap harness. 

        * @since 3.0

        */

        void ServiceL( const RMessage2& aMessage );

        /**

        * From CAknAppServiceBase, Called back by the server framework if this 

        * session's RunL function returns an error.

        * @since 3.0

        */

        void ServiceError( const RMessage2& aMessage, TInt aError );

        /**

        * From CAknAppServiceBase, Completes construction of this server-side 

        * client session object.

        * @since 3.0

        */

        void CreateL(); 

        /**

        * From MRequestCallback, Called when request is completed.

        * @since 3.0

        */

        void RequestCompleted( TInt aResult );

    public:

        /**

        * From MCUICancellable.       

        * @since 3.2

        * @return Boolean ETrue.

        */        

        TBool IsShowingDialog(); 

        /**

        * From MCUICancellable.      

        * @since 3.2

        */        

        void CancelEngine(); 

        /**

        * From MCUICancellable.      

        * @since 3.2

        */        

        void ForceCancel();

        /**

        * From MCUICancellable.      

        * @since 3.2

        */        

        void StartedCancellingL();          

    private:

        /**

        * Returns reference to the server.

        * @since 3.0

        * @return Reference to the server.

        */

        CSWInstServer& Server();

        /**

        * Handles the request.

        * @since 3.0

        * @param aMessage - Reference to the message that contains the request.

        */

        void HandleRequestL( const RMessage2& aMessage );

        /**

        * Helper to retrieve an int parameter from message.

        * @since 3.0

        * @param aMessage - Reference to the message that contains the request.

        * @param aIpcSlot - Slot where the parameter is retrieved.

        */

        TInt GetInt( const RMessage2& aMessage, TInt aIpcSlot ); 

        /**

        * Sends application to background.

        * @since 3.2        

        */        

        void SendAppToBackgroundL();  

        /**

        * Get parameters from descriptor. Adds url to iHeapSourceUrl

        * @since 3.1

        * @param aParamsDes - Descriptor containing inst. params and url.

        * @param aParams - Install params read form given descriptor.

        */        

        void GetReqParamsL( TDesC8& aParamsDes, TInstallReq& aParams );

    private: // Functions from base classes

        /**

        * From CApaAppServiceBase, Virtual framework function that is called 

        * on receipt of a message from the client. This allows the service 

        * implementation to define a security policy for messages from the client. 

        * @since 3.0

        */

        CPolicyServer::TCustomResult SecurityCheckL( const RMessage2& aMsg, 

                                                     TInt& aAction, 

                                                     TSecurityInfo& aMissing );        

    private:    // Data

        CSWInstRequestStore* iRequestStore;     

        MRequestCallback* iExitCallback;   

        TBool iAppInForeground;

        CommonUI::CCUICancelTimer* iCanceller; 

        HBufC* iHeapSourceUrl;

    };

}

#endif      // SWINSTSESSION_H   

// End of File