/*

* Copyright (c) 2004 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: Including  CLaunchRequest,CImpsAppLauncherProxy,MImpsAppLaunchHandler.

*              Starts a separate process to launch application

*/

#ifndef CIMPSAPPLAUNCHERPROXY_H

#define CIMPSAPPLAUNCHERPROXY_H

//  INCLUDES

#include <e32base.h>

#include "impsservercommon.h"

// FORWARD DECLARATIONS

class MImpsAppLaunchHandler;

// CLASS DECLARATION

/**

*  Launch request

*/

class CLaunchRequest : public CBase

    {

    public:

        static CLaunchRequest* NewL(

            const TDesC& aCID,

            const TDesC& aSAP,

            const TDesC& aUserId );

        ~CLaunchRequest();

        void Destroy();

        bool operator==( CLaunchRequest& rhs );

        const TDesC& ApplicationId();

        const TDesC& Sap();

        const TDesC& UserId();

    public: //data

        TDblQueLink             iLink;          //lint !e1925

    private:

        CLaunchRequest( );

        void ConstructL(

            const TDesC& aCID,

            const TDesC& aSAP,

            const TDesC& aUserId );

    private:

        HBufC*                  iCID;

        HBufC*                  iSAP;

        HBufC*                  iUserId;

    };

// CLASS DECLARATION

/**

*  Application launcher proxy

*  Starts a separate process to launch application

*  and manages the launch requests

*

*  @since 2.6

*/

class CImpsAppLauncherProxy : public CActive

    {

    public:  // Constructors and destructor

        /**

        * Two-phased constructor.

        * @param aLaunchObserver the application launch observer

        * @return CImpsAppLauncherProxy instance

        */

        static CImpsAppLauncherProxy* NewL( MImpsAppLaunchHandler* aLaunchObserver );

        /**

        * Destructor.

        */

        virtual ~CImpsAppLauncherProxy();

    public: // New functions

        /**

        * Initiates the application launch for the given Client ID

        * @since 2.6

        * @param aApplicationId the Application ID of the application to be started

        * @param aSAP the remote SAP server from where the pending IM came

        * @param aUserId teh user ID who received the IM

        * @return error Application

        */

        TInt LaunchApplicationL( const TDesC& aApplicationId,

                                 const TDesC& aSAP,

                                 const TDesC& aUserID );

    protected:  // New functions

        /**

        * Starts the process which loads the launcher ECom plugin

        * @since 2.6

        * @param aRequest

        * @return error status

        */

        TInt DoStartProcess( CLaunchRequest& aRequest );

    protected:  // Functions from base classes

        /**

        * From CActive

        */

        void DoCancel();

        void RunL();

        TInt RunError( TInt aError );

    private:

        /**

        * C++ default constructor.

        * @param aLaunchObserver the application launch observer

        */

        CImpsAppLauncherProxy( MImpsAppLaunchHandler* aLaunchObserver );

        /**

        * By default Symbian 2nd phase constructor is private.

        */

        void ConstructL();

        /**

        * Queues the request

        */

        void QueueRequest( CLaunchRequest& aRequest );

        /**

        * Process the next request in queue

        */

        void ProcessNextRequestL();

        /**

        * Checks whether the request is already in queue

        */

        TBool IsDuplicate( CLaunchRequest& aRequest );

    private:    // Data

        CLaunchRequest*         iCurrentRequest;   // the request being handled curently

        MImpsAppLaunchHandler*  iLaunchObserver; // callback handler

        TDblQue<CLaunchRequest> iRequestList; // request queue

    };

// CLASS DECLARATION

/**

*  Application launcher observer

*  Informs the result of the application launch

*

*  @since 2.6

*/

class MImpsAppLaunchHandler

    {

    public:

        virtual void HandleAppLaunch( const TDesC& aApplicationId, TInt aStatus ) = 0;

    };

#endif      // CIMPSAPPLAUNCHERPROXY_H   

// End of File