--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/installationservices/swi/source/sishelper/uissclienthandler.h Thu Dec 17 08:51:10 2009 +0200
@@ -0,0 +1,196 @@
+/*
+* Copyright (c) 2004-2009 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:
+* Declaration of Swi::CUissClientHandler class which is the client-side part
+* of the reverse completion mechanism used by SWI to communicate with the UI
+*
+*/
+
+
+/**
+ @file
+ @internalComponent
+*/
+
+#include <e32std.h>
+#include "../uiss/client/uissclient.h"
+#include "swi/msisuihandlers.h"
+#include "swi/launcher.h"
+#ifdef SYMBIAN_UNIVERSAL_INSTALL_FRAMEWORK
+namespace Usif
+ {
+ class CComponentInfo;
+ }
+#include "swi/nativecomponentinfo.h"
+#endif
+
+namespace Swi
+{
+class CSisRegistryPackage;
+class CUissCmdHandler;
+class CWriteStream;
+
+/**
+ * This class communicates asynchronously with UISS using reverse completion
+ * mechanism, making requests to UISS and receiving completions with requests
+ * to display dialogs to the user, which it does by calling back to UI
+ * implementation (see Swi::MUiHandler and Swi::Launcher).
+ *
+ * @note This class is similar to the class CInstCoordClient from Jetstream
+ *
+ * @see Swi::MUiHandler
+ * @see Swi::Launcher
+ *
+ * @internalComponent
+ * @released
+ */
+class CUissClientHandler : public CActive
+ {
+public:
+ static CUissClientHandler* NewL(MUiHandler& aUiHandler, TBool aActiveObjectMode = true);
+ static CUissClientHandler* NewLC(MUiHandler& aUiHandler, TBool aActiveObjectMode = true);
+
+ virtual ~CUissClientHandler();
+
+ // client methods
+
+ /**
+ * Performs installation asynchronously. The r/c mechanism is handled
+ * internally.
+ */
+ void InstallL(const CInstallPrefs& aInstallPrefs, const RArray<TInt>& aDeviceSupportedLanguages, TRequestStatus& aStatus, RThread& aServer);
+
+ #ifdef SYMBIAN_UNIVERSAL_INSTALL_FRAMEWORK
+ /**
+ * Retrieves component info asynchronously. The buffer management is handled internally.
+ */
+ void GetComponentInfoL(const CInstallPrefs& aInstallPrefs, Usif::CComponentInfo& aComponentInfo, TRequestStatus& aStatus, RThread& aServer);
+ #endif
+
+ /**
+ * Performs uninstallation asynchronously. The r/c mechanism is handled
+ * internally.
+ *
+ * @param aPackage Package to uninstall
+ */
+ void UninstallL(const CSisRegistryPackage& aPackage, TRequestStatus& aStatus);
+
+ /**
+ * Cancels operation in progress
+ */
+ void CancelOperation();
+
+ /**
+ * Used during synchronous operation to issue/process all
+ * requests until operation is complete.
+ */
+ void WorkUntilCompleteL();
+
+ /**
+ * Returns true if an install/uninstall operation is in
+ * progress. This is different to IsActive() which just returns
+ * true if we have an outstanding request on the UISS.
+ */
+ TBool IsBusy();
+
+private:
+ // static const TInt KBufSize=10*1024; ///< Initial size of the command buffer
+ static const TInt KBufSize=10; ///< Initial size of the command buffer
+
+ void Cancel(); // Weak attempt to stop any user calling Cancel directly.
+
+ CUissClientHandler(MUiHandler& aUiHandler, TBool aActiveObjectMode);
+
+ CUissClientHandler(const CUissClientHandler&); // Disable copy construction
+ const CUissClientHandler &operator=(const CUissClientHandler&); // Disable assignment
+
+ void ConstructL(); ///< Second phase construction function
+
+ /**
+ * Starts UISS in a new thread of the same SISHelper process. Later SWIS
+ * will connect to UISS to show dialogs.
+ *
+ * @return KErrNone or an error code
+ */
+ static TInt StartUiss();
+
+ /**
+ * UISS thread function to run UISS in the same process.
+ *
+ * @return KErrNone or an error code
+ */
+ static TInt UissThreadFunction(TAny *);
+
+ /**
+ * Creates a command handler object corresponding to the specified UI
+ * dialog request from SWIS
+ *
+ * @param aCode Dialog code (see CUissSession::TMessage)
+ *
+ * @return Command handler object (caller must destroy it)
+ */
+ CUissCmdHandler* UissCmdHandlerFactoryL(TInt aCommand) const;
+ void AllocBufL(TInt aSize); ///< [Re]allocates buffer to aSize
+ void HandleOverflowL(); ///< Increases UISS r/c command buffer size
+ void InitializeArgStreamL(const CInstallPrefs& aInstallPrefs);
+
+ /**
+ * Process a completion of an internal request to the UISS server.
+ */
+ virtual void RunL();
+
+
+ /**
+ * Propogate RunL failures to client via its TRequestStatus
+ */
+ virtual TInt RunError(TInt aError);
+
+ /**
+ * Cancel any internal request and complete the client request.
+ */
+ virtual void DoCancel();
+
+ void WaitForSisHelperShutdown();
+
+ MUiHandler& iUiHandler; ///< UI implementation
+ MCancelHandler* iCancelHandler;///< Internal cancel handler
+ HBufC8* iBuf; ///< Command buffer
+ TPtr8 iPtrIntoBuf;
+ RUissSession iUissSession; ///< UISS session
+
+ TBool iActiveObjectMode; ///< Normally true for CActive object mode, set to false for sync install
+ TRequestStatus* iClientStatus; ///< Client request status
+ CWriteStream* iArgsStream; ///< Saved copy of arguments stream
+ TPtrC8 iPtrIntoArgsStream;
+ enum { KUissClientIdle,
+ KUissClientInstalling,
+ KUissClientUninstalling
+ #ifdef SYMBIAN_UNIVERSAL_INSTALL_FRAMEWORK
+ , KUissClientGettingCompInfo
+ #endif
+ } iState;
+ RThread iSisHelper;
+
+ #ifdef SYMBIAN_UNIVERSAL_INSTALL_FRAMEWORK
+ void AllocCompInfoBufL(TInt aBufSize);
+ void ConstructCompInfoFromBufferL();
+ Usif::CComponentInfo::CNode* MapToComponentInfoL(CNativeComponentInfo& aNativeComponentInfo);
+
+ HBufC8* iCompInfoBuffer; //< Component Information storage buffer
+ TPtr8 iCompInfoBufPtr;
+
+ Usif::CComponentInfo* iComponentInfo;
+ #endif
+ };
+} // namespace Swi