installationservices/swi/source/swis/server/restoreprocessor.h
author Pat Downey <patd@symbian.org>
Wed, 01 Sep 2010 12:22:02 +0100
branchRCL_3
changeset 66 8b7f4e561641
parent 65 7333d7932ef7
permissions -rw-r--r--
Revert incorrect RCL_3 drop: Revision: 201033 Kit: 201035

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


/**
 @file 
 @internalComponent 
*/

#ifndef __RESTOREPROCESSOR_H__
#define __RESTOREPROCESSOR_H__

#include <e32base.h>

#include "processor.h"
#include "securitymanager.h"
#include "installationprocessor.h"
#include "restorecontroller.h"
#include "sisregistrywritablesession.h"

#ifndef SYMBIAN_UNIVERSAL_INSTALL_FRAMEWORK
class CIntegrityServices;
#endif

namespace Swi 
	{
	class CPlan;
	
	/**
	 * State machine to handle securely restoring files the user
	 * has requested to be restored, and writing registry entries for
	 * same.
	 *
	 * @internalComponent
	 * @released
	 */
	
	class CRestoreProcessor : public CActive
		{
	protected:
		enum TProcessingState
			{
			EInitialize,
			EProcessFiles,
			EVerifyPaths,
			EInstallFiles,
			EUpdateRegistry,
			EFinished,
			ECurrentState=128, // Used to change to the current state
		};

		
	public:
		static CRestoreProcessor* NewL(const CPlan& aPlan, const TDesC8& aControllerBuffer, 
			CSecurityManager& aSecurityManager,	
#ifdef SYMBIAN_UNIVERSAL_INSTALL_FRAMEWORK
			Usif::RStsSession& aStsSession, RSisRegistryWritableSession& aRegistrySession,
#else
			CIntegrityServices& aIntegrityServices,
#endif
			const RPointerArray<CRestoreController::CSisCertificateVerifier>& aVerifiers,
			RArray<TUid>& aSids, RSwiObserverSession& aObserver);
		
		static CRestoreProcessor* NewLC(const CPlan& aPlan, const TDesC8& aControllerBuffer,
			CSecurityManager& aSecurityManager, 
#ifdef SYMBIAN_UNIVERSAL_INSTALL_FRAMEWORK
			Usif::RStsSession& aStsSession, RSisRegistryWritableSession& aRegistrySession,
#else
			CIntegrityServices& aIntegrityServices,
#endif
			const RPointerArray<CRestoreController::CSisCertificateVerifier>& aVerifiers,
			RArray<TUid>& aSids, RSwiObserverSession& aObserver);
			
		~CRestoreProcessor();
		
		void ProcessPlanL(TRequestStatus& aClientStatus);		
		
	protected:
		virtual TInt RunError(TInt aError);
		virtual void DoCancel();
		virtual void RunL();
		
		void SwitchState(TProcessingState aNextState);
		
	private:
		CRestoreProcessor(const CPlan& aPlan, const TDesC8& aControllerBuffer,
			CSecurityManager& aSecurityManager,	
#ifdef SYMBIAN_UNIVERSAL_INSTALL_FRAMEWORK
			Usif::RStsSession& aStsSession, RSisRegistryWritableSession& aRegistrySession,
#else
			CIntegrityServices& aIntegrityServices,
#endif
			const RPointerArray<CRestoreController::CSisCertificateVerifier>& aVerifiers,
			RSwiObserverSession& aObserver);
		
		void ConstructL(RArray<TUid>& aSids);
		void ProcessApplicationL(const CApplication& aApplication, TRequestStatus& aClientStatus);		
	private:
	
		// Processor states, called by the state machine
	
		TBool DoStateInitializeL();
		TBool DoStateInstallFilesL();
		TBool DoStateVerifyPathsL();
		TBool DoStateUpdateRegistryL();
		TBool DoStateProcessFilesL();
		void DoStateFinishedL();
		
		void InstallFileL(const CSisRegistryFileDescription& aRegistryFileDescription);
		void ExtractHashL(const CSisRegistryFileDescription& aFileToProcess);
		
	private:		
		const RPointerArray<CRestoreController::CSisCertificateVerifier>& iVerifiers; // verifiers for the sis controllers being restored
		CSecurityManager& iSecurityManager; // Security manager for this restore session
		TInt iCurrent; // current index of a file to be processed
		RArray<TUid> iSids; // SIDs of executables installed
		
		RFs iFs;
		
		const TDesC8& iControllerBuffer;	/// Reference to the raw controller buffer for iPlan
		const CPlan& iPlan;
		const CApplication* iApplication;
		TRequestStatus* iClientStatus;
#ifdef SYMBIAN_UNIVERSAL_INSTALL_FRAMEWORK
		Usif::RStsSession& iStsSession;
		RSisRegistryWritableSession& iRegistrySession;
		/** The list of software types to be registered found in the XML registration file. */
		RCPointerArray<CSoftwareTypeRegInfo> iSoftwareTypeRegInfoArray;
#else
		CIntegrityServices& iIntegrityServices;
#endif
		TProcessingState iState;
		CFileMan* iFileMan;
		
		/// The drive on which to store device integrity data (hashes, registry etc) 
		TChar iSystemDriveChar;
		RSwiObserverSession& iObserver; ///< SWI Observer session handle provided by SWIS.
		};
	}

#endif //__RESTOREPROCESSOR_H__