IMPSengine/engsrv/inc/impsapplauncherproxy.h
changeset 0 094583676ce7
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/IMPSengine/engsrv/inc/impsapplauncherproxy.h	Thu Dec 17 08:41:52 2009 +0200
@@ -0,0 +1,175 @@
+/*
+* 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