1 /*

     2 * Copyright (c) 2008-2009 Nokia Corporation and/or its subsidiary(-ies).

     3 * All rights reserved.

     4 * This component and the accompanying materials are made available

     5 * under the terms of the License "Eclipse Public License v1.0"

     6 * which accompanies this distribution, and is available

     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8 *

     9 * Initial Contributors:

    10 * Nokia Corporation - initial contribution.

    11 *

    12 * Contributors:

    13 *

    14 * Description: 

    15 * This file defines a SIF plug-in for the Reference Installer.

    16 *

    17 */

    18 

    19 

    20 /**

    21  @file

    22  @internalComponent

    23  exampleCode

    24 */

    25 

    26 #ifndef SIFREFPLUGIN_H

    27 #define SIFREFPLUGIN_H

    28 

    29 #include <usif/sif/sifplugin.h>

    30 #include <e32base.h>

    31 #include <e32std.h>

    32 #include "sifrefinstallerclient.h"

    33 

    34 namespace Usif

    35 	{

    36 	/**

    37 	An active object used by the CSifRefPlugin class to submit asynchronous requests.

    38 	

    39 	ECOM objects and CActive do not interact well - especially since SIFPlugin inherits

    40 	from CBase and double C-inheritance is impossible. So, a separate class is used to drive

    41 	asynchronous software management requests.

    42 	*/

    43 	NONSHARABLE_CLASS(CSifRefPluginActiveImpl) : public CActive

    44 	{

    45 	public:

    46 		static CSifRefPluginActiveImpl* NewL();

    47 		~CSifRefPluginActiveImpl();

    48 

    49 		/* CActive interface */

    50 		void RunL();

    51 		void DoCancel();

    52 

    53 		/* CSifPlugin interface */

    54 		void GetComponentInfo(const TDesC& aFileName, const TSecurityContext& aSecurityContext,

    55 							CComponentInfo& aComponentInfo, TRequestStatus& aStatus);

    56 

    57 		void GetComponentInfo(RFile& aFileHandle, const TSecurityContext& aSecurityContext,

    58 							CComponentInfo& aComponentInfo, TRequestStatus& aStatus);

    59 

    60 		void Install(const TDesC& aFileName, const TSecurityContext& aSecurityContext,

    61 					const COpaqueNamedParams& aInputParams, COpaqueNamedParams& aOutputParams,

    62 					TRequestStatus& aStatus);

    63 

    64 		void Install(RFile& aFileHandle, const TSecurityContext& aSecurityContext,

    65 					const COpaqueNamedParams& aInputParams, COpaqueNamedParams& aOutputParams,

    66 					TRequestStatus& aStatus);

    67 

    68 		void Uninstall(TComponentId aComponentId, const TSecurityContext& aSecurityContext,

    69 						const COpaqueNamedParams& aInputParams, COpaqueNamedParams& aOutputParams, 

    70 						TRequestStatus& aStatus);

    71 

    72 		void Activate(TComponentId aComponentId, const TSecurityContext& aSecurityContext,

    73 						TRequestStatus& aStatus);

    74 

    75 		void Deactivate(TComponentId aComponentId, const TSecurityContext& aSecurityContext,

    76 						TRequestStatus& aStatus);

    77 

    78 	private:

    79 		CSifRefPluginActiveImpl() : CActive(EPriorityStandard) {}

    80 		CSifRefPluginActiveImpl(const CSifRefPluginActiveImpl&);

    81 		CSifRefPluginActiveImpl& operator =(const CSifRefPluginActiveImpl&);

    82 		void ConstructL();

    83 		TBool CommonRequestPreamble(const TSecurityContext& aSecurityContext, const COpaqueNamedParams& aInputParams, 

    84 									COpaqueNamedParams& aOutputParams, TRequestStatus& aStatus);

    85 	private:

    86 		RSifRefInstallerClient iTransporter;

    87 		TRequestStatus* iClientStatus;

    88 		const COpaqueNamedParams* iInputParams;

    89 		COpaqueNamedParams* iOutputParams;

    90 		};

    91 

    92 	/*

    93 	An implementation of the CSifPlugin interface for the Reference Installer.

    94 	

    95 	The SIF Server loads and uses this plug-in when the MIME type of a package is 'binary/sif-refpkg'.

    96 	*/

    97 	NONSHARABLE_CLASS(CSifRefPlugin) : public CSifPlugin

    98 		{

    99 	public:

   100 		static CSifRefPlugin* NewL();

   101 		~CSifRefPlugin();

   102 

   103 		/* CSifPlugin interface */

   104 		void GetComponentInfo(const TDesC& aFileName, const TSecurityContext& aSecurityContext,

   105 							CComponentInfo& aComponentInfo, TRequestStatus& aStatus);

   106 

   107 		void GetComponentInfo(RFile& aFileHandle, const TSecurityContext& aSecurityContext,

   108 							CComponentInfo& aComponentInfo, TRequestStatus& aStatus);

   109 		

   110 		void Install(const TDesC& aFileName, const TSecurityContext& aSecurityContext,

   111 							const COpaqueNamedParams& aInputParams, COpaqueNamedParams& aOutputParams,

   112 							TRequestStatus& aStatus);

   113 

   114 		void Install(RFile& aFileHandle, const TSecurityContext& aSecurityContext,

   115 							const COpaqueNamedParams& aInputParams, COpaqueNamedParams& aOutputParams,

   116 							TRequestStatus& aStatus);

   117 

   118 		virtual void Uninstall(TComponentId aComponentId, const TSecurityContext& aSecurityContext,

   119 								const COpaqueNamedParams& aInputParams, COpaqueNamedParams& aOutputParams,

   120 								TRequestStatus& aStatus);

   121 

   122 		virtual void Activate(TComponentId aComponentId, const TSecurityContext& aSecurityContext,

   123 								TRequestStatus& aStatus);

   124 

   125 		virtual void Deactivate(TComponentId aComponentId, const TSecurityContext& aSecurityContext,

   126 								TRequestStatus& aStatus);

   127 

   128 		void CancelOperation();

   129 

   130 	private:

   131 		CSifRefPlugin() {}

   132 		void ConstructL();

   133 		CSifRefPlugin(const CSifRefPlugin &);

   134 		CSifRefPlugin& operator =(const CSifRefPlugin &);

   135 

   136 		CSifRefPluginActiveImpl *iImpl;

   137 		};

   138 	} // end namespace Usif

   139 

   140 #endif // SIFREFPLUGIN_H