/*

* 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: 

* fileextractor.cpp

* Component which handles extracting of files asynchronously

*

*/

/**

 @file

 @internalTechnology

*/

#ifndef __FILEEXTRACTOR_H__

#define __FILEEXTRACTOR_H__

#include <e32base.h>

#include "appinfo.h"

class RFs;

class RFile;

namespace Swi

{

class CSisRegistryFileDescription;

class RSisHelper;

class RUiHandler;

/**

 * This class is an active object, which manages file extraction in chunks, using SISHelper

 */

class CFileExtractor : public CActive

	{

public:

	static CFileExtractor* NewLC(RFs& aFs, RSisHelper& aSisHelper, RUiHandler& aUiHandler, const TAppInfo& aAppInfo);

	static CFileExtractor* NewL(RFs& aFs, RSisHelper& aSisHelper, RUiHandler& aUiHandler, const TAppInfo& aAppInfo);

	/**

	 * Extract the file, using provided file handle which must be set up correctly.

	 */	

	void ExtractFileL(TInt aDataUnit, const CSisRegistryFileDescription& aFileDescription, RFile& aFile, TRequestStatus& aStatus);

	/**

	 * Extract the file, using provided file handle which must be set up correctly.

	 */	

	void ExtractFileL(TInt aDataUnit, const CSisRegistryFileDescription& aFileDescription, const TDesC& aFileName, TRequestStatus& aStatus);

	~CFileExtractor();

private:

	CFileExtractor(RFs& aFs, RSisHelper& aSisHelper, RUiHandler& aUiHandler, const TAppInfo& aAppInfo);	

	void ConstructL();

// from CActive

	void RunL();

	void DoCancel();

	TInt RunError(TInt aError);

	/// Sets up the file handle, owned by the file extractor for the duration of the extraction

	void SetupFileHandleL(const TDesC& aFileName);

	/// finishes the extraction and notifies the client of the result

	TInt FinishExtraction(TInt aResult);	

private:	

	RFs&	iFs;

	RSisHelper& iSisHelper;

	RUiHandler& iUiHandler;

	const TAppInfo& iAppInfo;

	TRequestStatus* iClientStatus;

	TBool iCancelled;

	TInt iBytesToExtract;

	RFile* iCurrentFile;

	CSisRegistryFileDescription* iFileDescription;

	TInt32 iDataUnit;

	TBool iManagedFileHandle; // whether we manage the file handle used for file extraction.

	};

}

#endif // #ifndef __FILEEXTRACTOR_H__