--- /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