tsrc/VCXTestCommon/inc/CIptvTestVerifyData.h
author Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
Mon, 21 Jun 2010 15:43:03 +0300
branchRCL_3
changeset 45 baf439b22ddd
parent 0 96612d01cf9f
permissions -rw-r--r--
Revision: 201023 Kit: 2010125

/*
* Copyright (c) 2008 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: 
*
*/


/*

Testmodule needs two new blocks:
 EnableVerifying
  - Parameters: verify ID, appendmode: 0 = if verify file exists it will be
    overwritten, 1 data is written to end of file
  - Verify ID can be the Case ID
  - Calls IptvTestUtility::CreateVerifyData
  - The case can call EnableVerifying block of multiple modules. Verify ID should be same in each call,
    just use append mode in other calls but the first.
  - If this has not been called then IptvTestUtility::VerifyData and
    IptvTestUtility::WriteVerifyData do nothing

 Verify
  - Parameters: The verify ID used in the case
  - Calls IptvTestUtility::VerifyData(CaseId) for the ID
  - Case should call Verify block only once, even EnableVerifying is called for multiple test modules

 After call to EnableVerifying the test module can write data with two different
 IptvTestUtility::WriteVerifyData methods.

 VerifyData will fail at the first time it's called. This is because it can't
 find already verified file to compare with the one generated during the case run.
 The unverified file can be found from E (or C if MMC is not installed) drive
 in the folder: \iptvtest\verify\<VerifyID>.txt. This file must be verified by
 hand and copied to IPTV_engine\internal\data\verify.

 Note: Only logs from HW test runs should be accepted. Emulator and HW might give
 different results.

 IPTV_engine\internal\sis\generateverifylist.pl script generates
 internal\data\verifyExports.inf file which exports the verified files to
 correct locations. internal\sis\pkgExports.txt is also created and the
 lines inside must be copied to STIF_IPTV_Engine.pkg. The verified files will
 be installed in c:\Testframework\Iptvtest\verify folder on the terminal.

 File & directory summary.
 1. (E/C):\iptvtest\verify\<VerifyID>.txt (on hardware)
 	- Generated during the case run
 2. internal\data\verify
 	- #1 should be copied here after it has been verified manually for first time.
 3. c:\Testframework\Iptvtest\verify (on hardware)
  	- Verified files are installed here. Compared to #1
 4. internal\sis\generateverifylist.pl
 	- Creates files #5 & #6
 5. internal\data\verifyExports.inf
 	- Exports the files in folders: epoc32\winscw\c\testframework\iptvtest\verify
					epoc32\data\Z\System\Data\Iptvtest\Verify
 6. \internal\sis\pkgExports.txt
  	- Pkg lines for the files, copy to STIF_IPTV_Engine.pkg

Example case:

[Test]
title ET39000 Data verifying example
create IptvProvisioningTest ProvTest
create IptvServiceManagementApiTest SMTest
SMTest DeleteServicesDb
ProvTest Create
ProvTest EnableVerifying ET39000 	// first module and first call will create new data file
ProvTest LocalProvision "c:\TestFramework\testvod_services.xml"
create IptvVodContentApiTest VCTest
VCTest Create SERV_1
VCTest EnableVerifying ET39000 APPEND 	// second module will append to the same file
VCTest SelectIap 3G_AP
VCTest UpdateEcg
waittestclass VCTest
VCTest VerifyAllCategoryContent KIptvVodContentCategoryRootId
ProvTest Verify ET39000  		// only one module will do the verifying
VCTest Destroy
delete VCTest
ProvTest Destroy
delete ProvTest
SMTest Destroy
delete SMTest
[Endtest]

*/


#ifndef CIPTVTESTVERIFYDATA_H
#define CIPTVTESTVERIFYDATA_H

//  INCLUDES
#include <e32base.h>
#include <e32cmn.h> // RArray
#include <f32file.h> // RFs
#include <BAUTILS.H>
#include <S32FILE.H>

// CONSTANTS
const TInt KIptvTestErrVerifyFailed = -1112;
_LIT(KIptvVerifyZipFile, "c:\\testing\\data\\verifyzip\\verify.zip" );

// MACROS

// DATA TYPES

// FUNCTION PROTOTYPES

// FORWARD DECLARATIONS
class CZipFile;

// CLASS DECLARATION

class CVerifyFile : public CBase
	{
	public:
		static CVerifyFile* CVerifyFile::NewL();

		virtual ~CVerifyFile();

	// data

		TBuf<64> iId;

		/**
	    * Returns the file name and path where case data is written to be verified
	    * @since
	    * @param aFileName pointer to descriptor where file name is written
	    * @return Error code, KErrNone if no errors,
	    */
		void GetFileToWrite(TDes& aFileName);

		void CreateNewFile();

		void WriteData(TDesC& aData);

		void CloseFileHandles();

	protected:
		CVerifyFile();
		void ConstructL();

	private:
		RFs iFs;
		HBufC* iFileName;
		TBool iFileOpen;
		RFileWriteStream iFileStream;
		RFile iFile;

		void OpenStream();
		void ResolveFileName();
	};


/**
*
*  @since
*/
class CIptvTestVerifyData : public CBase
    {
    public:  // Constructors and destructor

		enum TVerifyResult
			{
			EVerifyOk = 0,
			EVerifyFailed = -1112,
			EVerifiedFileNotFound = -1111,
			EFileToVerifyNotFound = -1110,
			ESystemError = -1109
			};

        /**
        * Two-phased constructor.
        */
        IMPORT_C static CIptvTestVerifyData* NewL();


        /**
        * Destructor.
        */
        IMPORT_C virtual ~CIptvTestVerifyData();


    public: // New functions

  		/**
        * Initializes the verify file, deletes if the file exists
        * @since
        * @param aVerifyId An id to identify the file where verify data is written
        * @return Error code, KErrNone if no errors,
        */
		IMPORT_C TInt CreateVerifyDataL(TDesC& aVerifyId, TBool aAppend);

		/**
        * Writes verify data to a file
        * @since
        * @param aVerifyId An id to identify the file where verify data is written
        * @param aVerifyData Data to write into the file
        * @return Error code, KErrNone if no errors,
        */
		IMPORT_C TInt WriteVerifyDataL(TDesC& aVerifyId, TDesC& aVerifyData);

		/**
        * Verifies the results, result is written to aVerifyResult
        * @since
        * @param aVerifyId An id to identify the files which are compared
        * @return Error code, KErrNone if no errors,
        */
		IMPORT_C TInt VerifyDataL(TDesC& aVerifyId, TVerifyResult& aVerifyResult);

        /**
        * Enables timestamp writing to the file.
        * @since
        * @param aUseTimestamps
        * @return Error code, KErrNone if no errors,
        */
        IMPORT_C void EnableTimestamps( TBool aUseTimestamps );

    protected: //from base classes

    private:

        /**
        * C++ default constructor.
        */
        CIptvTestVerifyData();

        /**
        * By default Symbian 2nd phase constructor is private.
        */
        void ConstructL();

    	TInt GetVerifyFileIndex(TInt& aIndex, TDesC& aVerifyId);

    	/*
    	 * Reads a file into the buffer.
    	 */
    	TInt ReadFileL(RFs& aFs, TDes& aFileName, HBufC8** aBuff, TVerifyResult& aVerifyResult);

    	/*
    	 * Extracts a file from zip file.
    	 */
    	void ExtractVerifyFileL( TDesC& aVerifyId, const TDesC& aDestFile );

    	/*
    	 * Checks if file exists in zip file.
    	 */
    	TBool FileExistsInZip( CZipFile* aZipFile, const TDesC& aFileName );

    private:    // Data
		RFs iFs;

		RPointerArray<CVerifyFile> iVerifyFiles;

		CZipFile* iZipFile;

		TBool iUseTimestamps;

		HBufC* iBuffer;
    };

#endif      // CIPTVTESTVERIFYDATA_H

// End of File