sl@0: // Copyright (c) 2004-2009 Nokia Corporation and/or its subsidiary(-ies).
sl@0: // All rights reserved.
sl@0: // This component and the accompanying materials are made available
sl@0: // under the terms of "Eclipse Public License v1.0"
sl@0: // which accompanies this distribution, and is available
sl@0: // at the URL "http://www.eclipse.org/legal/epl-v10.html".
sl@0: //
sl@0: // Initial Contributors:
sl@0: // Nokia Corporation - initial contribution.
sl@0: //
sl@0: // Contributors:
sl@0: //
sl@0: // Description:
sl@0: // CPDTextLoader class
sl@0: // 
sl@0: //
sl@0: 
sl@0: #define __INCLUDE_CAPABILITY_NAMES__
sl@0: #define __REFERENCE_CAPABILITY_NAMES__
sl@0: #include "e32capability.h"
sl@0: 
sl@0: #include "SC_Strings.h"
sl@0: #include "SC_TextIn.h"
sl@0: 
sl@0: namespace DBSC
sl@0: {
sl@0: 
sl@0: /**
sl@0: Max capability count, when SID or VID used.
sl@0: @internalComponent
sl@0: */
sl@0: const TInt KMaxCapabilityCount1 = 3;
sl@0: 
sl@0: /**
sl@0: Max capability count, when no SID and no VID are used.
sl@0: @internalComponent
sl@0: */
sl@0: const TInt KMaxCapabilityCount2 = 7;
sl@0: 
sl@0: static TInt CompareCapabilities(const TCapability& aLeft, const TCapability& aRight)
sl@0: 	{
sl@0: 	return aRight - aLeft;
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: TStmtProps describes an object representing text file statement type and value
sl@0: (the right side of "=" expression)
sl@0: @internalComponent
sl@0: */
sl@0: struct TStmtProps
sl@0: 	{
sl@0: 	inline TStmtProps() :
sl@0: 		iType(EStmtTEof),
sl@0: 		iValue(NULL, 0)
sl@0: 		{
sl@0: 		}
sl@0: 	TStmtType	iType;
sl@0: 	TPtrC		iValue;
sl@0: 	};
sl@0: 
sl@0: /**
sl@0: StmtType2Class() function returns the statement class of the supplied statement type parameter.
sl@0: @param aType Statement type.
sl@0: @return Statement class.
sl@0: @internalComponent
sl@0: */
sl@0: static TStmtClass StmtType2Class(TStmtType aType)
sl@0: 	{
sl@0: 	switch(aType)
sl@0: 		{
sl@0: 		case EStmtTComment: 
sl@0: 		case EStmtTBlank: 
sl@0: 			return EStmtCNoData;
sl@0: 		case EStmtTDatabase: 
sl@0: 		case EStmtTTable: 
sl@0: 			return EStmtCPolicyObj;
sl@0: 		case EStmtTRead: 
sl@0: 		case EStmtTWrite: 
sl@0: 		case EStmtTSchema: 
sl@0: 			return EStmtCPolicyType;
sl@0: 		case EStmtTCapability:
sl@0: 		case EStmtTSID: 
sl@0: 		case EStmtTVID: 
sl@0: 			return EStmtCPolicyItem;
sl@0: 		case EStmtTBackup:
sl@0: 			return EStmtCBackup;
sl@0: 		default:
sl@0: 			break;
sl@0: 		}
sl@0: 	return EStmtCInvalid;
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Capabilities count.
sl@0: @internalComponent
sl@0: */
sl@0: 
sl@0: const TInt KCapabilityCount = sizeof(CapabilityNames) / sizeof(CapabilityNames[0]);
sl@0: 
sl@0: /**
sl@0: CapabilityName2Id() function searches and returns the related capability ID having
sl@0: the capability name as an input parameter.
sl@0: @param aName Capability name
sl@0: @return Related to aName capability ID
sl@0: @internalComponent
sl@0: */
sl@0: static TCapability CapabilityName2Id(const TDesC& aName)
sl@0: 	{
sl@0: 	const TInt KMaxCapabilityStringLen = 20;
sl@0: 
sl@0: 	TBufC8<KMaxCapabilityStringLen> cap;
sl@0: 	TPtr8 capPtr (cap.Des());
sl@0: 
sl@0: 	capPtr.Copy(aName);
sl@0:  
sl@0:  	for(TInt i=0;i<KCapabilityCount;++i)
sl@0: 		{	
sl@0: 		if(0 == capPtr.CompareF(TBuf8<20>((TText8*)CapabilityNames[i])))
sl@0: 			return (TCapability)i;
sl@0: 		}			
sl@0: 	return (TCapability) -1; // Return 'None' if no other capabilities are found
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Statement keywords, which format is:
sl@0: <Keyword>
sl@0: KStmtKeywordT1 array is in 1:1 relation with KStmtT1 array, except the last KStmtT1 
sl@0: member - EStmtTInvalid - it does not have a match in KStmtKeywordT1 array.
sl@0: @internalComponent
sl@0: */
sl@0: const TDesC* const KStmtKeywordT1[] = 
sl@0: 	{
sl@0: 	&KDbStr(), &KTblStr(), &KReadStr(), &KWriteStr(), &KSchemaStr(), &KBackupStr()
sl@0: 	};
sl@0: 
sl@0: /**
sl@0: Statements count, which format is:
sl@0: <Keyword>
sl@0: @internalComponent
sl@0: */
sl@0: const TInt KStmtT1Count = sizeof(KStmtKeywordT1) / sizeof(KStmtKeywordT1[0]);
sl@0: 
sl@0: /**
sl@0: Statement IDs, which format is:
sl@0: <Keyword>
sl@0: KStmtKeywordT1 array is in 1:1 relation with KStmtT1 array, except the last KStmtT1 
sl@0: member - EStmtTInvalid - it does not have a match in KStmtKeywordT1 array.
sl@0: "EStmtTInvalid" always has to be the last array element.
sl@0: @internalComponent
sl@0: */
sl@0: const TStmtType KStmtT1[KStmtT1Count + 1] = 
sl@0: 	{ 
sl@0: 	EStmtTDatabase, EStmtTTable, EStmtTRead, EStmtTWrite, EStmtTSchema, EStmtTBackup, EStmtTInvalid
sl@0: 	};
sl@0: 
sl@0: /**
sl@0: StmtKeywordT1ToId() function searches and returns the related statement ID having
sl@0: the statement keyword as an input parameter.
sl@0: @param aKeyword Statement keyword
sl@0: @return Related to aKeyword statement ID
sl@0: @internalComponent
sl@0: */
sl@0: static TStmtType StmtKeywordT1ToId(const TDesC& aKeyword)
sl@0: 	{
sl@0: 	TInt i;
sl@0: 	for(i=0;i<KStmtT1Count && aKeyword.CompareF(*(KStmtKeywordT1[i]));++i)
sl@0: 		{
sl@0: 		}
sl@0: 	return KStmtT1[i];
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Statement keywords, which format is:
sl@0: <Keyword>=<Data>
sl@0: KStmtKeywordT2 array is in 1:1 relation with KStmtT2 array, except the last KStmtT2 
sl@0: member - EStmtTInvalid - it does not have a match in KStmtKeywordT2 array.
sl@0: @internalComponent
sl@0: */
sl@0: const TDesC* const KStmtKeywordT2[] = 
sl@0: 	{
sl@0: 	&KNameStr(), &KCapabilityStr(), &KSIDStr(), &KVIDStr()
sl@0: 	};
sl@0: 
sl@0: /**
sl@0: Statements count, which format is:
sl@0: <Keyword>=<Data>
sl@0: @internalComponent
sl@0: */
sl@0: const TInt KStmtT2Count = sizeof(KStmtKeywordT2) / sizeof(KStmtKeywordT2[0]);
sl@0: 
sl@0: /**
sl@0: Statement IDs, which format is:
sl@0: <Keyword>=<Data>
sl@0: KStmtKeywordT2 array is in 1:1 relation with KStmtT2 array, except the last KStmtT2 
sl@0: member - EStmtTInvalid - it does not have a match in KStmtKeywordT2 array.
sl@0: EStmtTInvalid always has to be the last element in KStmtT2 array.
sl@0: @internalComponent
sl@0: */
sl@0: const TStmtType KStmtT2[KStmtT2Count + 1] = 
sl@0: 	{ 
sl@0: 	EStmtTName, EStmtTCapability, EStmtTSID, EStmtTVID, EStmtTInvalid
sl@0: 	};
sl@0: 
sl@0: /**
sl@0: StmtKeywordT2ToId() function searches and returns the related statement ID having
sl@0: the statement keyword as an input parameter.
sl@0: @param aKeyword Statement keyword
sl@0: @return Related to aKeyword statement ID
sl@0: @internalComponent
sl@0: */
sl@0: static TStmtType StmtKeywordT2ToId(const TDesC& aKeyword)
sl@0: 	{
sl@0: 	TInt i;
sl@0: 	for(i=0;i<KStmtT2Count && aKeyword.CompareF(*(KStmtKeywordT2[i]));++i)
sl@0: 		{
sl@0: 		}
sl@0: 	return KStmtT2[i];
sl@0: 	}
sl@0: 
sl@0: /** 
sl@0: TDes::Trim() does not work properly when the descriptor length is 0, 
sl@0: or the descriptor holds a NULL pointer.
sl@0: @internalComponent 
sl@0: */
sl@0: static void Trim(TDes& aDes) 
sl@0: 	{
sl@0: 	if(aDes.Length() > 0)
sl@0: 		{
sl@0: 		aDes.Trim();
sl@0: 		}
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: StmtType2PolicyType() function returns the related to aStmtType value - policy type.
sl@0: @param aStmtType Statement type
sl@0: @return The related policy type - R/W/S
sl@0: @internalComponent
sl@0: */
sl@0: static TPolicyType StmtType2PolicyType(TStmtType aStmtType) 
sl@0: 	{
sl@0: 	switch(aStmtType)
sl@0: 		{
sl@0: 		case EStmtTRead:
sl@0: 			return EPTRead;
sl@0: 		case EStmtTWrite:
sl@0: 			return EPTWrite;
sl@0: 		case EStmtTSchema:
sl@0: 			return EPTSchema;
sl@0: 		default:
sl@0: 			break;
sl@0: 		}
sl@0: 	return EPTNone;
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Creates TSecurityPolicy instance of type 1: SID and a set of up to 3 capabilities.
sl@0: @param aSid Security ID
sl@0: @param aCapabilities Capabilities array.
sl@0: @param aSecurityPolicy Output. Created security policy.
sl@0: @internalComponent
sl@0: */
sl@0: static void CreateSecurityPolicyT1(TSecureId aSid, const RArray<TCapability>& aCapabilities, 
sl@0: 									TSecurityPolicy& aSecurityPolicy)
sl@0: 	{
sl@0: 	TInt count = aCapabilities.Count();
sl@0: 	if(count == 0)
sl@0: 		{
sl@0: 		aSecurityPolicy = TSecurityPolicy(aSid);
sl@0: 		}
sl@0: 	else if(count == 1)
sl@0: 		{
sl@0: 		aSecurityPolicy = TSecurityPolicy(aSid, aCapabilities[0]);
sl@0: 		}
sl@0: 	else if(count == 2)
sl@0: 		{
sl@0: 		aSecurityPolicy = TSecurityPolicy(aSid, aCapabilities[0], aCapabilities[1]);
sl@0: 		}
sl@0: 	else if(count == 3)
sl@0: 		{
sl@0: 		aSecurityPolicy = TSecurityPolicy(aSid, aCapabilities[0], aCapabilities[1], aCapabilities[2]);
sl@0: 		}
sl@0: 	else
sl@0: 		{
sl@0: 		User::Invariant();
sl@0: 		}
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Creates TSecurityPolicy instance of type 2: VID and a set of up to 3 capabilities.
sl@0: @param aVid Vendor ID
sl@0: @param aCapabilities Capabilities array.
sl@0: @param aSecurityPolicy Output. Created security policy.
sl@0: @internalComponent
sl@0: */
sl@0: static void CreateSecurityPolicyT2(TVendorId aVid, const RArray<TCapability>& aCapabilities, 
sl@0: 									TSecurityPolicy& aSecurityPolicy)
sl@0: 	{
sl@0: 	TInt count = aCapabilities.Count();
sl@0: 	if(count == 0)
sl@0: 		{
sl@0: 		aSecurityPolicy = TSecurityPolicy(aVid);
sl@0: 		}
sl@0: 	else if(count == 1)
sl@0: 		{
sl@0: 		aSecurityPolicy = TSecurityPolicy(aVid, aCapabilities[0]);
sl@0: 		}
sl@0: 	else if(count == 2)
sl@0: 		{
sl@0: 		aSecurityPolicy = TSecurityPolicy(aVid, aCapabilities[0], aCapabilities[1]);
sl@0: 		}
sl@0: 	else if(count == 3)
sl@0: 		{
sl@0: 		aSecurityPolicy = TSecurityPolicy(aVid, aCapabilities[0], aCapabilities[1], aCapabilities[2]);
sl@0: 		}
sl@0: 	else
sl@0: 		{
sl@0: 		User::Invariant();
sl@0: 		}
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Creates TSecurityPolicy instance of type 3: A set of up to 7 capabilities.
sl@0: @param aCapabilities Capabilities array.
sl@0: @param aSecurityPolicy Output. Created security policy.
sl@0: @internalComponent
sl@0: */
sl@0: static void CreateSecurityPolicyT3(const RArray<TCapability>& aCapabilities, TSecurityPolicy& aSecurityPolicy)
sl@0: 	{
sl@0: 	TInt count = aCapabilities.Count();
sl@0: 	if(count == 1)
sl@0: 		{
sl@0: 		aSecurityPolicy = TSecurityPolicy(aCapabilities[0]);
sl@0: 		}
sl@0: 	else if(count == 2)
sl@0: 		{
sl@0: 		aSecurityPolicy = TSecurityPolicy(aCapabilities[0], aCapabilities[1]);
sl@0: 		}
sl@0: 	else if(count == 3)
sl@0: 		{
sl@0: 		aSecurityPolicy = TSecurityPolicy(aCapabilities[0], aCapabilities[1], aCapabilities[2]);
sl@0: 		}
sl@0: 	else if(count == 4)
sl@0: 		{
sl@0: 		aSecurityPolicy = TSecurityPolicy(aCapabilities[0], aCapabilities[1], aCapabilities[2], aCapabilities[3]);
sl@0: 		}
sl@0: 	else if(count == 5)
sl@0: 		{
sl@0: 		aSecurityPolicy = TSecurityPolicy(aCapabilities[0], aCapabilities[1], aCapabilities[2], aCapabilities[3], aCapabilities[4]);
sl@0: 		}
sl@0: 	else if(count == 6)
sl@0: 		{
sl@0: 		aSecurityPolicy = TSecurityPolicy(aCapabilities[0], aCapabilities[1], aCapabilities[2], aCapabilities[3], aCapabilities[4], aCapabilities[5]);
sl@0: 		}
sl@0: 	else if(count == 7)
sl@0: 		{
sl@0: 		aSecurityPolicy = TSecurityPolicy(aCapabilities[0], aCapabilities[1], aCapabilities[2], aCapabilities[3], aCapabilities[4], aCapabilities[5], aCapabilities[6]);
sl@0: 		}
sl@0: 	else
sl@0: 		{
sl@0: 		User::Invariant();
sl@0: 		}
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Creates TSecurityPolicy instance (initializing aSecurityPolicy parameter).
sl@0: @param aSid Security ID
sl@0: @param aVid Vendor ID
sl@0: @param aCapabilities Capabilities array.
sl@0: @leave KErrCorrupt Bad set of SID/VID/Capabilities
sl@0: @internalComponent
sl@0: */
sl@0: static void CreateSecurityPolicyL(TSecureId aSid, TVendorId aVid, 
sl@0: 								  const RArray<TCapability>& aCapabilities, 
sl@0: 								  TSecurityPolicy& aSecurityPolicy)
sl@0: 	{
sl@0: 	TInt cababilityCount = aCapabilities.Count();
sl@0: 	if(aSid != 0 && aVid != 0)
sl@0: 		{
sl@0: 		__LEAVE(KErrCorrupt);
sl@0: 		}
sl@0: 	if(aSid != 0 || aVid != 0)
sl@0: 		{
sl@0: 		if(cababilityCount > KMaxCapabilityCount1)
sl@0: 			{
sl@0: 			__LEAVE(KErrCorrupt);
sl@0: 			}
sl@0: 		if(aSid != 0)
sl@0: 			{
sl@0: 			DBSC::CreateSecurityPolicyT1(aSid, aCapabilities, aSecurityPolicy);
sl@0: 			}
sl@0: 		else
sl@0: 			{
sl@0: 			DBSC::CreateSecurityPolicyT2(aVid, aCapabilities, aSecurityPolicy);
sl@0: 			}
sl@0: 		}
sl@0: 	else if(cababilityCount > KMaxCapabilityCount2 || cababilityCount == 0)
sl@0: 		{
sl@0: 		__LEAVE(KErrCorrupt);
sl@0: 		}
sl@0: 	else
sl@0: 		{
sl@0: 		DBSC::CreateSecurityPolicyT3(aCapabilities, aSecurityPolicy);
sl@0: 		}
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: */
sl@0: inline CPDTextLoader::CPDTextLoader()
sl@0: 	{
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Standard phase-one factory method for CPDTextLoader instance.
sl@0: CPDTextLoader instance will be used for loading a set of security policies information 
sl@0: from a text file, creating the related security policy objects and adding them to 
sl@0: a CPolicyDomain collection.
sl@0: @param aFs File server session
sl@0: @param aTextFileName Full text file path, which will be used as an input.
sl@0: @return A pointer to just created CPDTextLoader instance.
sl@0: @leave System-wide error codes, including KErrNoMemory.
sl@0: */
sl@0: CPDTextLoader* CPDTextLoader::NewLC(RFs& aFs, const TDesC& aTextFileName)
sl@0: 	{
sl@0: 	CPDTextLoader* self = new (ELeave) CPDTextLoader;
sl@0: 	CleanupStack::PushL(self);
sl@0: 	self->ConstructL(aFs, aTextFileName);
sl@0: 	return self;
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: */
sl@0: CPDTextLoader::~CPDTextLoader()
sl@0: 	{
sl@0: 	iRdStream.Close();
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Standard phase-two construction method for CPDTextLoader instance.
sl@0: @param aFs File server session
sl@0: @param aTextFileName Full text file path, which will be used as an input.
sl@0: */
sl@0: void CPDTextLoader::ConstructL(RFs& aFs, const TDesC& aTextFileName)
sl@0: 	{
sl@0: 	__LEAVE_IF_ERROR(iRdStream.Open(aFs, aTextFileName, EFileRead | EFileStreamText));
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: MPolicyDomainLoader::RunL() implementation, which is used to load security policies
sl@0: from a text file, create the related security policy objects and add them
sl@0: to CPolicyDomain instance, controlled by aPolicyDomainBuilder object.
sl@0: It is not called directly, but will be called back.
sl@0: @param aPolicyDomainBuilder TPolicyDomainBuilder instance, which will be used to add
sl@0:        created security policy objects to the controlled by it collection. 
sl@0: @leave System-wide error codes
sl@0: */
sl@0: void CPDTextLoader::RunL(TPolicyDomainBuilder& aPolicyDomainBuilder)
sl@0: 	{
sl@0: 	TStmtProps stmtProps;
sl@0: 	const CDbPolicy* dbPolicy = LoadDbPolicyL(aPolicyDomainBuilder, stmtProps);
sl@0: 	__ASSERT(dbPolicy);
sl@0: 	LoadTblPoliciesL(aPolicyDomainBuilder, stmtProps, dbPolicy);
sl@0: 	LoadBackupSIDL(aPolicyDomainBuilder, stmtProps);
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: The method returns ETrue if this is the end of file.
sl@0: @return ETrue - EOF, EFalse otherwise
sl@0: */
sl@0: TBool CPDTextLoader::IsEofL()
sl@0: 	{
sl@0: 	return iRdStream.Source()->TellL(MStreamBuf::ERead) >= iRdStream.Source()->SizeL();
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: The method parses a line from the text file, detects its type and gets the right side
sl@0: of "=" as a text line data descriptor. The information will be stored in aStmtProps
sl@0: parameter. If the text line is not recognizable, the method leaves with KErrCorrupt.
sl@0: Recognizable text line formats are:
sl@0: <[keyword]>
sl@0: <keyword>
sl@0: <keyword>=<value>
sl@0: <;>[comments]
sl@0: <blank line>
sl@0: @param aStmt Current text line
sl@0: @param aStmtProps The collected information will be stored there. Output parameter.
sl@0: @leave KErrCorrupt - the text line has unknown format
sl@0: */
sl@0: void CPDTextLoader::GetStmtPropsL(const TDesC& aStmt, TStmtProps& aStmtProps) const
sl@0: 	{
sl@0: 	aStmtProps.iValue.Set(aStmt);
sl@0: 	if(aStmt.Length() == 0)
sl@0: 		{
sl@0: 		aStmtProps.iType = EStmtTBlank;
sl@0: 		return;
sl@0: 		}
sl@0: 	else if(aStmt[0] == ';')
sl@0: 		{
sl@0: 		aStmtProps.iType = EStmtTComment;
sl@0: 		return;
sl@0: 		}
sl@0: 	TBool res = TryGetStmt1Props(aStmt, aStmtProps);
sl@0: 	if(!res)
sl@0: 		{
sl@0: 		res = TryGetStmt2Props(aStmt, aStmtProps);
sl@0: 		}
sl@0: 	if(!res)
sl@0: 		{
sl@0: 		__LEAVE(KErrCorrupt);
sl@0: 		}
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Tries to process a text line as a:
sl@0: <keyword>
sl@0: or
sl@0: <[keyword]>
sl@0: @param aStmt Current text line
sl@0: @param aStmtProps Output parameter
sl@0: @return ETrue, if it is recognizable text line. Then the method will set the text line type 
sl@0: 			   in aStmtProps.iType data member.
sl@0: 		EFalse This is not recognizable text line with <keyword> or <[keyword]> format.
sl@0: */
sl@0: TBool CPDTextLoader::TryGetStmt1Props(const TDesC& aStmt, TStmtProps& aStmtProps) const
sl@0: 	{
sl@0: 	aStmtProps.iType = DBSC::StmtKeywordT1ToId(aStmt);
sl@0: 	return aStmtProps.iType != EStmtTInvalid;
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Tries to process a text line as a:
sl@0: <keyword>=<value>
sl@0: @param aStmt Current text line
sl@0: @param aStmtProps Output parameter
sl@0: @return ETrue, if it is recognizable text line. Then the method will set the text line type 
sl@0: 			   in aStmtProps.iType data member and the line value in aStmtProps.iValue
sl@0: 			   data member. The text will be converted to a upper case.
sl@0: 		EFalse This is not recognizable text line with <keyword>=<value> format.
sl@0: */
sl@0: TBool CPDTextLoader::TryGetStmt2Props(const TDesC& aStmt, TStmtProps& aStmtProps) const
sl@0: 	{
sl@0: 	TInt eqPos = aStmt.Find(KEqStr);
sl@0: 	if(eqPos != KErrNotFound && eqPos < (aStmt.Length() - 1))
sl@0: 		{
sl@0: 		TPtr stmtKeyword(const_cast <TText*> (aStmt.Left(eqPos).Ptr()), eqPos, eqPos);
sl@0: 		DBSC::Trim(stmtKeyword);
sl@0: 		aStmtProps.iType = DBSC::StmtKeywordT2ToId(stmtKeyword);
sl@0: 		if(aStmtProps.iType != EStmtTInvalid)
sl@0: 			{
sl@0: 			TInt valPos = eqPos + 1;
sl@0: 			TInt valLen = aStmt.Length() - valPos;
sl@0: 			TPtr value(const_cast <TText*> (aStmt.Mid(valPos).Ptr()), valLen, valLen);
sl@0: 			DBSC::Trim(value);
sl@0: 			aStmtProps.iValue.Set(value);
sl@0: 			return ETrue;
sl@0: 			}
sl@0: 		}
sl@0: 	return EFalse;
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: The method loads a single text line from the file in the place, pointed by aStmt parameter.
sl@0: @param aStmt The place, where the text line data will be stored
sl@0: @return ETrue This not the end of file, the information in aStmt is valid.
sl@0:         EFalse End of file.
sl@0: @leave System-wide error codes, including KErrCorrupt - unknown file format.
sl@0:  */
sl@0: TBool CPDTextLoader::LoadStmtL(TPtr& aStmt)
sl@0: 	{
sl@0: 	if(IsEofL())
sl@0: 		{
sl@0: 		return EFalse;
sl@0: 		}
sl@0: 	TChar char_LF('\n');
sl@0: 	iStmt8.Zero();
sl@0: 	iRdStream.ReadL(iStmt8, char_LF);
sl@0: 	aStmt.Copy(iStmt8);
sl@0: 	const TInt len = aStmt.Length();
sl@0: 	if(len < 2)
sl@0: 		{//Unknown text file format. The text line should have at the end CR-LF pair.
sl@0: 		__LEAVE(KErrCorrupt);
sl@0: 		}
sl@0: 	if(TChar(aStmt[len - 1]) != char_LF)
sl@0: 		{//Too long line
sl@0: 		__LEAVE(KErrCorrupt);
sl@0: 		}
sl@0: 	aStmt.SetLength(len - 1);
sl@0: 	//The last character is (CR). Check for (LF).
sl@0: 	TChar char_CR('\r');
sl@0: 	if(TChar(aStmt[len - 2]) == char_CR)
sl@0: 		{
sl@0: 		aStmt.SetLength(len - 2);
sl@0: 		}
sl@0: 	DBSC::Trim(aStmt);	
sl@0: 	return ETrue;
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: The method loads a single text line from the file in the place, pointed by iStmt data member
sl@0: skipping lines with comments and blank lines.
sl@0: @param aStmtProps Output parameter. It will be initialized after the call.
sl@0: @return Statement class.
sl@0: @leave System-wide error codes, including KErrCorrupt - unknown file format.
sl@0: */
sl@0: TStmtClass CPDTextLoader::LoadNextStmtL(TStmtProps& aStmtProps)
sl@0: 	{
sl@0: 	TPtr stmt(const_cast <TText*> (iStmt.Ptr()), 0, iStmt.MaxLength());
sl@0: 	TStmtClass stmtClass = EStmtCInvalid;
sl@0: 	do
sl@0: 		{
sl@0: 		if(!LoadStmtL(stmt))
sl@0: 			{
sl@0: 			aStmtProps.iType = EStmtTEof;
sl@0: 			break;
sl@0: 			}
sl@0: 		GetStmtPropsL(stmt, aStmtProps);
sl@0: 		}
sl@0: 	while((stmtClass = DBSC::StmtType2Class(aStmtProps.iType)) == EStmtCNoData);
sl@0: 	return stmtClass;
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: The method loads a single text line from the file in the place, pointed by iStmt data member
sl@0: skipping lines with comments and blank lines. The loaded text line type is expected to be
sl@0: aStmtType.
sl@0: @param aStmtProps Output parameter. It will be initialized after the call.
sl@0: @param aStmtType Expected type of the loaded text line.
sl@0: @leave System-wide error codes, including KErrCorrupt - unknown file format or the loaded line type is 
sl@0:        not the expected type.
sl@0: */
sl@0: void CPDTextLoader::LoadNextStmtOfTypeL(TStmtProps& aStmtProps, TStmtType aStmtType)
sl@0: 	{
sl@0: 	(void)LoadNextStmtL(aStmtProps);
sl@0: 	if(aStmtProps.iType != aStmtType)
sl@0: 		{
sl@0: 		__LEAVE(KErrCorrupt);
sl@0: 		}
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: The method loads all database policy related data from the text file.
sl@0: @param aPolicyDomainBuilder TPolicyDomainBuilder instance, which will be used to add
sl@0:        created database security policy object to the controlled by it policy collection. 
sl@0: @param aStmtProps The information about the last loaded text line.
sl@0: @return A const pointer to just created database policy object from loaded text data.
sl@0: @leave System-wide error codes.
sl@0: */
sl@0: const CDbPolicy* CPDTextLoader::LoadDbPolicyL(TPolicyDomainBuilder& aPolicyDomainBuilder, 
sl@0: 												TStmtProps& aStmtProps)
sl@0: 	{
sl@0: 	LoadNextStmtOfTypeL(aStmtProps, EStmtTDatabase);
sl@0: 
sl@0: 	CPolicyBase::RPolicyCollection policyColl;
sl@0: 	CleanupClosePushL(policyColl);
sl@0: 
sl@0: 	LoadSecurityPoliciesL(policyColl, aStmtProps);
sl@0: 
sl@0: 	CDbPolicy* dbPolicy = CDbPolicy::NewLC(policyColl);
sl@0: 	aPolicyDomainBuilder.SetDbPolicyL(dbPolicy);
sl@0: 	CleanupStack::Pop(dbPolicy);
sl@0: 
sl@0: 	CleanupStack::PopAndDestroy(&policyColl);
sl@0: 	return dbPolicy;
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: The method loads all table policy related data from the text file.
sl@0: @param aPolicyDomainBuilder TPolicyDomainBuilder instance, which will be used to add
sl@0:        created table security policy objects to the controlled by it policy collection. 
sl@0: @param aStmtProps The information about the last loaded text line.
sl@0: @param aDbPolicy A const pointer to the database policy object, created previously from loaded text data.
sl@0: @leave System-wide error codes.
sl@0: */
sl@0: void CPDTextLoader::LoadTblPoliciesL(TPolicyDomainBuilder& aPolicyDomainBuilder, 
sl@0: 									 TStmtProps& aStmtProps, const CDbPolicy* aDbPolicy)
sl@0: 	{
sl@0: 	__ASSERT(aDbPolicy);
sl@0: 	CPolicyBase::RPolicyCollection policyColl;
sl@0: 	CleanupClosePushL(policyColl);
sl@0: 	while(aStmtProps.iType == EStmtTTable)
sl@0: 		{
sl@0: 		LoadNextStmtOfTypeL(aStmtProps, EStmtTName);
sl@0: 		TBufC<KMaxFileName> tableName;
sl@0: 		tableName = aStmtProps.iValue;
sl@0: 
sl@0: 		LoadSecurityPoliciesL(policyColl, aStmtProps);
sl@0: 
sl@0: 		CTblPolicy* tblPolicy = CTblPolicy::NewLC(tableName, policyColl, aDbPolicy);
sl@0: 		aPolicyDomainBuilder.AddTblPolicyL(tblPolicy);
sl@0: 		CleanupStack::Pop(tblPolicy);
sl@0: 		}
sl@0: 	CleanupStack::PopAndDestroy(&policyColl);
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: The method loads the backup & restore SID, if it is in the file.
sl@0: @param aPolicyDomainBuilder TPolicyDomainBuilder instance, which will be used to store
sl@0:        loaded backup & restore SID. 
sl@0: @param aStmtProps The information about the last loaded text line.
sl@0: @leave System-wide error codes.
sl@0: */
sl@0: void CPDTextLoader::LoadBackupSIDL(TPolicyDomainBuilder& aPolicyDomainBuilder, 
sl@0: 								   TStmtProps& aStmtProps)
sl@0: 	{
sl@0: 	TSecureId backupSID((TUint32)ECapability_None);//ECapability_None is used in TSecurityPolicy constructors too.
sl@0: 	if(aStmtProps.iType == EStmtTBackup)
sl@0: 		{
sl@0: 		LoadNextStmtOfTypeL(aStmtProps, EStmtTSID);
sl@0: 		backupSID = GetIdL(aStmtProps.iValue);
sl@0: 		}
sl@0: 	else if(aStmtProps.iType != EStmtTEof)
sl@0: 		{
sl@0: 		__LEAVE(KErrCorrupt);
sl@0: 		}
sl@0: 	aPolicyDomainBuilder.SetBackupSID(backupSID);
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: The method loads all database/table related security policy information from the text file.
sl@0: @param aPolicyColl Output parameter - an array, which elements type is CPolicyBase::RPolicyCollection.
sl@0:                    The collected from the text file security policy information wil be stored there.
sl@0: @param aStmtProps The information about the last loaded text line.
sl@0: @leave System-wide error codes.
sl@0: */
sl@0: void CPDTextLoader::LoadSecurityPoliciesL(CPolicyBase::RPolicyCollection& aPolicyColl, 
sl@0: 										  TStmtProps& aStmtProps)
sl@0: 	{
sl@0: 	aPolicyColl.Reset();
sl@0: 	(void)LoadNextStmtL(aStmtProps);
sl@0: 	while(DBSC::StmtType2Class(aStmtProps.iType) == EStmtCPolicyType)
sl@0: 		{
sl@0: 		CPolicyBase::TPolicy policy;
sl@0: 		policy.iType = DBSC::StmtType2PolicyType(aStmtProps.iType);
sl@0: 		__ASSERT(policy.iType != EPTNone);
sl@0: 		LoadSecurityPolicyL(policy.iData, aStmtProps);
sl@0: 		__LEAVE_IF_ERROR(aPolicyColl.Append(policy));
sl@0: 		}
sl@0: 	if(aPolicyColl.Count() == 0)
sl@0: 		{
sl@0: 		__LEAVE(KErrCorrupt);
sl@0: 		}
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: The method loads a single security policy from the text file.
sl@0: @param aSecurityPolicy Output parameter - the information from the file will be stored there.
sl@0:                    The collected from the text file security policy information wil be stored there.
sl@0: @param aStmtProps The information about the last loaded text line.
sl@0: @leave System-wide error codes.
sl@0: */
sl@0: void CPDTextLoader::LoadSecurityPolicyL(TSecurityPolicy& aSecurityPolicy, 
sl@0: 										TStmtProps& aStmtProps)
sl@0: 	{
sl@0: 	TSecureId sid(0);
sl@0: 	TVendorId vid(0);
sl@0: 	RArray<TCapability> capabilities;
sl@0: 	CleanupClosePushL(capabilities);
sl@0: 	while(LoadNextStmtL(aStmtProps) == EStmtCPolicyItem)
sl@0: 		{
sl@0: 		if(aStmtProps.iType == EStmtTCapability)
sl@0: 			{
sl@0: 			GetCapabilitiesL(aStmtProps.iValue, capabilities);
sl@0: 			}
sl@0: 		else if(aStmtProps.iType == EStmtTSID)
sl@0: 			{
sl@0: 			if(sid != 0) 
sl@0: 				{//duplicated SID text line
sl@0: 				__LEAVE(KErrCorrupt);
sl@0: 				}
sl@0: 			sid = GetIdL(aStmtProps.iValue);
sl@0: 			}
sl@0: 		else if(aStmtProps.iType == EStmtTVID)
sl@0: 			{
sl@0: 			if(vid != 0) 
sl@0: 				{//duplicated VID text line
sl@0: 				__LEAVE(KErrCorrupt);
sl@0: 				}
sl@0: 			vid = GetIdL(aStmtProps.iValue);
sl@0: 			}
sl@0: 		else
sl@0: 			{
sl@0: 			__ASSERT(0);
sl@0: 			}
sl@0: 		}
sl@0: 	if(capabilities.Count() == 0 && sid == 0 && vid == 0)
sl@0: 		{//invalid security policy data
sl@0: 		__LEAVE(KErrCorrupt);
sl@0: 		}
sl@0: 	DBSC::CreateSecurityPolicyL(sid, vid, capabilities, aSecurityPolicy);
sl@0: 	CleanupStack::PopAndDestroy(&capabilities);
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: The method parses a string with capabilities information and puts found capabilities in aCapability
sl@0: output parameter.
sl@0: @param aCapabilityStr Capabilities string.
sl@0: @param aCapabilities The collected capabilities will be stored there.
sl@0: @leave System-wide error codes. KErrCorrupt, if aCapability is not 0, which means there are
sl@0:        2 or more capability strings for the same policy.    
sl@0: */
sl@0: void CPDTextLoader::GetCapabilitiesL(const TDesC& aCapabilityStr, 
sl@0: 									 RArray<TCapability>& aCapabilities) const
sl@0: 	{
sl@0: 	if(aCapabilities.Count() > 0)
sl@0: 		{//No more than one "capability" statement in the text file!
sl@0: 		__LEAVE(KErrCorrupt);
sl@0: 		}
sl@0: 	TLinearOrder<TCapability> linearOrder(&DBSC::CompareCapabilities);
sl@0: 	TLex lex(aCapabilityStr);
sl@0: 	for(TPtrC token=lex.NextToken();token.Length()!=0;token.Set(lex.NextToken()))
sl@0: 		{
sl@0: 		TCapability cap = DBSC::CapabilityName2Id(token);
sl@0: 		if(cap != ECapability_Limit)
sl@0: 			{//InsertInOrder() - to warn the user in case of duplicates 
sl@0: 			__LEAVE_IF_ERROR(aCapabilities.InsertInOrder(cap, linearOrder));
sl@0: 			}
sl@0: 		else
sl@0: 			{
sl@0: 			__LEAVE(KErrGeneral);//Unknown capability
sl@0: 			}
sl@0: 		}
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: @param aStr A string with SID or VID.
sl@0: @return The UID, extracted from the string
sl@0: @leave System-wide error codes.
sl@0: */
sl@0: TUint CPDTextLoader::GetIdL(const TDesC& aStr) const
sl@0: 	{
sl@0: 	TLex lex(aStr);
sl@0: 	TUint id;
sl@0: 	__LEAVE_IF_ERROR(lex.Val(id, EHex));
sl@0: 	if(id == 0)
sl@0: 		{
sl@0: 		__LEAVE(KErrCorrupt);
sl@0: 		}
sl@0: 	return id;
sl@0: 	}
sl@0: 
sl@0: } //end of - namespace DBSC