--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/xml/xmlfw/test/rtest/tsrc/tp_perftestbase.h	Thu Dec 17 09:29:21 2009 +0200
@@ -0,0 +1,155 @@
+// 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 "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:
+// Generic performance test framework
+// 
+//
+
+/**
+ @file 
+ @internalComponent
+*/
+
+#ifndef TP_FRAMEWORK_H
+#define TP_FRAMEWORK_H
+
+#include <e32std.h>
+#include <f32file.h>
+
+/**
+Typedef for method pointer
+*/
+typedef TAny (*TFuncPtr)();
+
+/** 
+The class purpose is to store all necessary details of API method to call. 
+*/
+class TApiRecord
+	{
+	public:
+		TApiRecord(const TDesC8& aAPIName, TFuncPtr aAPIPtr, TUint64 aMaxDuration);
+		
+
+	public:
+		void SetAPIPtr(TFuncPtr aAPIPtr);
+		const TDesC8& APIName();
+		
+		void SetAPIName(TDesC8& aAPIName);
+		TFuncPtr APIPtr();
+		
+		void SetMaxDuration(TUint64 aMaxDuration);
+		TUint64 MaxDuration();
+		
+	private:
+		/**
+		API method name
+		*/
+		TBuf8<100> iAPIName;
+		
+		/**
+		API method pointer
+		*/
+		TFuncPtr iAPIPtr;
+		
+		/**
+		The maximum duration of the performance test for that API method
+		*/
+		TUint64 iMaxDuration;
+	};
+	
+/**
+Typedef to simplify usage of the Api record list.
+*/
+typedef RPointerArray<TApiRecord> RApiList;
+
+/** 
+The base clase for API performance testing. 
+The class users should inherit from this class to use the performance test functionality. 
+
+The user needs to provide a number of test methods, which should be a friend to the class. 
+Each of this method should have a call to ApiTestStart and ApiTestEnd methods, which 
+should enclose particular functionality (API method) for performance testing. It allows to 
+performance test only requried functionality leaving out of test scope the test preparation 
+and post test activity.
+
+Here is the test method prototype:
+void TestAPIMethod()
+	{
+		// test preparation here
+	apiTest->ApiTestStart();
+		// call to the API method
+	apiTest->ApiTestEnd();
+		// post test activity
+	}
+
+The framework will call all test methods required number of times for perfromance testing. 
+The test results will be shown on the console and logged into result file in "C:\Log" directory. 
+*/
+class CPerformanceTests : public CBase
+	{
+
+public:
+	void RunTestsL();
+	~CPerformanceTests();
+
+public: 
+	/**
+	User should implement GetMethodList to create full list of require API method to test
+	*/
+	virtual void GetMethodListL(RApiList& aApiList) = 0;
+	
+	/**
+	User should implement GetNumberOfRepetition to inform the framework about the number
+	of repetitions for performance testing. 
+	*/
+	virtual TInt GetNumberOfRepetition() = 0;
+	
+	/**
+	User should implement this method for some general purpose test preparation. 
+	*/
+	virtual void PrepareTestsL() = 0;
+	
+private:
+	void TestApi(TApiRecord& aApi);
+
+protected:
+	void ConstructL(const TDesC& aTestName);
+	CPerformanceTests();
+	void ApiTestStart();
+	void ApiTestEnd();
+	void ParserComandLineL();
+			
+private:
+	/** The list of methods to perform the test on */
+	RApiList list; 		
+
+	/** Output log file handle */
+	RFile output; 		
+	
+	/** RF session for logging */
+	RFs session;	
+	
+	/** Start time of API call */
+	TUint64 iStartTime; 
+
+	/** End time of API call */
+	TUint64 iEndTime;    
+
+	/** Number of required repetition */
+	TInt iRepNum;
+
+	/** Name of outpu file */
+	HBufC* iOutputFile;
+	};
+
+#endif // TP_FRAMEWORK_H