--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/installationservices/refswinstallationplugin/inc/sifrefbinpkgextractor.h	Tue Aug 31 15:21:33 2010 +0300
@@ -0,0 +1,129 @@
+/*
+* 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 class responsible for extracting files from a compound package.
+*
+*/
+
+
+/**
+ @file
+ @internalComponent
+ exampleCode
+*/
+
+#ifndef SIFREFBINPKGEXTRACTOR_H
+#define SIFREFBINPKGEXTRACTOR_H
+
+#include <e32base.h>
+#include <f32file.h>
+#include <bacline.h>
+#include <usif/sts/sts.h>
+#include <usif/sts/sts.h>
+#include <usif/sif/sifcommon.h>
+
+namespace Usif
+	{
+	namespace SifRefBinPkgExtractor
+		{
+	
+		/**
+		CAuxNode is an auxiliary node class used for the processing of reference embedded packages
+		without implementing a walk-tree algorithm. The BuildPkgTreeL() function takes a list of CAuxNode
+		objects as an argument and fills it with extracted packages.
+		*/
+		class CAuxNode : public CBase
+			{
+		public:
+			/**
+			Creates an instance of the CAuxNode object.
+			*/
+			static CAuxNode* NewLC(const TDesC& aFileName, TBool aForeign, CAuxNode& aParent);
+			static CAuxNode* NewLC(const RFile& aFile, TBool aForeign, CAuxNode& aParent);
+			/**
+			Destructor.
+			*/
+			virtual ~CAuxNode();
+
+			/**
+			Returns the name of the extracted package associated with this auxiliary node.
+			*/
+			const TDesC& FileNameL() const { return *iFileName; }
+
+			/**
+			Checks if the extracted package associated with this node it a root component.
+			*/
+			TBool Root() const { return iParent == NULL; }
+
+			/**
+			Checks if the extracted package associated with this node is of the reference type.
+			*/
+			TBool Foreign() const { return iForeign; }
+
+			/**
+			Associates aCompInfo with this auxiliary node.
+			*/
+			void SetCompInfoL(CComponentInfo* aCompInfo);
+
+			/**
+			Associates aNode with this auxiliary node.
+			*/
+			void SetNodeL(CComponentInfo::CNode* aNode);
+
+			/**
+			Sets the CNode object associated with this auxiliary node as a root node of aCompInfo.
+			*/
+			void SetAsRootNodeL(CComponentInfo& aCompInfo);
+
+			/**
+			Registers a child CNode object associated with this auxiliary node to its parrent.
+			This method is provided for build a tree of CComponentInfo nodes from a flat tree
+			of auxiliary nodes. After this call the auxiliary node is no longer associated with its
+			CNode object.
+			*/
+			void RegisterChildToParentL();
+			
+		private:
+			CAuxNode();
+			CAuxNode& operator=(const CAuxNode& other);
+			CAuxNode(const CAuxNode& other);
+
+			TBool iForeign;
+			HBufC* iFileName;
+			CAuxNode* iParent;
+			CComponentInfo::CNode* iNode;
+			CComponentInfo* iCompInfo;
+			};
+		
+		/**
+		Builds a tree of the files embedded in the reference binary package specified by aInFileName.
+		The paths to the extracted embedded packages are returned in aFlatTree. This flat list can be
+		simply processed asynchronously without implementing a walk-tree algorithm in the Active Object
+		context. However, it contains the information needed to build a real tree of the
+		CComponentInfo::CNode objects.
+		*/
+		void BuildPkgTreeL(RStsSession& aSts, const TDesC& aInFileName, const TDesC& aTempDir, RPointerArray<CAuxNode>& aFlatTree, CAuxNode* aParent = NULL);
+
+		/**
+		Builds a tree of the files embedded in the reference binary package specified by aInFile.
+		The paths to the extracted embedded packages are returned in aFlatTree. This flat list can be
+		simply processed asynchronously without implementing a walk-tree algorithm in the Active Object
+		context. However, it contains the information needed to build a real tree of the
+		CComponentInfo::CNode objects.
+		*/
+		void BuildPkgTreeL(RStsSession& aSts, RFile& aInFile, const TDesC& aTempDir, RPointerArray<CAuxNode>& aFlatTree, CAuxNode* aParent = NULL);
+		}
+	}
+
+#endif //  SIFREFBINPKGEXTRACTOR_H