/*

* Copyright (c) 2008-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: 

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

*

*/

/**

 @file

 @internalComponent

 exampleCode

*/

#ifndef SIFREFPLUGIN_H

#define SIFREFPLUGIN_H

#include <usif/sif/sifplugin.h>

#include <e32base.h>

#include <e32std.h>

#include "sifrefinstallerclient.h"

namespace Usif

	{

	/**

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

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

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

	asynchronous software management requests.

	*/

	NONSHARABLE_CLASS(CSifRefPluginActiveImpl) : public CActive

	{

	public:

		static CSifRefPluginActiveImpl* NewL();

		~CSifRefPluginActiveImpl();

		/* CActive interface */

		void RunL();

		void DoCancel();

		/* CSifPlugin interface */

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

							CComponentInfo& aComponentInfo, TRequestStatus& aStatus);

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

							CComponentInfo& aComponentInfo, TRequestStatus& aStatus);

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

					const COpaqueNamedParams& aInputParams, COpaqueNamedParams& aOutputParams,

					TRequestStatus& aStatus);

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

					const COpaqueNamedParams& aInputParams, COpaqueNamedParams& aOutputParams,

					TRequestStatus& aStatus);

		void Uninstall(TComponentId aComponentId, const TSecurityContext& aSecurityContext,

						const COpaqueNamedParams& aInputParams, COpaqueNamedParams& aOutputParams, 

						TRequestStatus& aStatus);

		void Activate(TComponentId aComponentId, const TSecurityContext& aSecurityContext,

						TRequestStatus& aStatus);

		void Deactivate(TComponentId aComponentId, const TSecurityContext& aSecurityContext,

						TRequestStatus& aStatus);

	private:

		CSifRefPluginActiveImpl() : CActive(EPriorityStandard) {}

		CSifRefPluginActiveImpl(const CSifRefPluginActiveImpl&);

		CSifRefPluginActiveImpl& operator =(const CSifRefPluginActiveImpl&);

		void ConstructL();

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

									COpaqueNamedParams& aOutputParams, TRequestStatus& aStatus);

	private:

		RSifRefInstallerClient iTransporter;

		TRequestStatus* iClientStatus;

		const COpaqueNamedParams* iInputParams;

		COpaqueNamedParams* iOutputParams;

		};

	/*

	An implementation of the CSifPlugin interface for the Reference Installer.

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

	*/

	NONSHARABLE_CLASS(CSifRefPlugin) : public CSifPlugin

		{

	public:

		static CSifRefPlugin* NewL();

		~CSifRefPlugin();

		/* CSifPlugin interface */

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

							CComponentInfo& aComponentInfo, TRequestStatus& aStatus);

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

							CComponentInfo& aComponentInfo, TRequestStatus& aStatus);

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

							const COpaqueNamedParams& aInputParams, COpaqueNamedParams& aOutputParams,

							TRequestStatus& aStatus);

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

							const COpaqueNamedParams& aInputParams, COpaqueNamedParams& aOutputParams,

							TRequestStatus& aStatus);

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

								const COpaqueNamedParams& aInputParams, COpaqueNamedParams& aOutputParams,

								TRequestStatus& aStatus);

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

								TRequestStatus& aStatus);

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

								TRequestStatus& aStatus);

		void CancelOperation();

	private:

		CSifRefPlugin() {}

		void ConstructL();

		CSifRefPlugin(const CSifRefPlugin &);

		CSifRefPlugin& operator =(const CSifRefPlugin &);

		CSifRefPluginActiveImpl *iImpl;

		};

	} // end namespace Usif

#endif // SIFREFPLUGIN_H