/*

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

* Note: This file may contain code to generate corrupt files for test purposes.

* Such code is excluded from production builds by use of compiler defines;

* it is recommended that such code should be removed if this code is ever published publicly.

* generic base for all SIS binary large objects

*

*/

/**

 @file 

 @publishedPartner

 @released

*/

#ifndef __BLOB_H__

#define __BLOB_H__

#include <iostream>

#include <algorithm>

#include <assert.h>

#include "utility_interface.h"

#include "field.h"

#include "exception.h"

#include "utility.h"

template <CSISFieldRoot::TFieldType FieldType> class CBlob : public CSISField <FieldType>

	{

public:

	/**

	 * Default constructor.

	 */

	CBlob ();

	/**

	 * Copy constructor

	 */

	CBlob (const CBlob& aInitialiser);

	/**

	 * Destructor

	 */

	virtual ~CBlob ();

public:

	/**

	 * Internalize the class

	 * @param aFile File stream from where data needs to be read.

	 * @param aContainerSize size of the content to be read.

	 * @param aArrayType Type of the array 

	 */

	virtual void Read (TSISStream& aFile, const CSISFieldRoot::TFieldSize& aContainerSize, const CSISFieldRoot::TFieldType aArrayType = CSISFieldRoot::ESISUndefined);

	/**

	 * Externalize the class

	 * @param aFile File stream to which the data needs to be written.

	 * @param aIsArrayElement whether the structure is part of an array or not. 

	 */

	virtual void Write (TSISStream& aFile, const bool aIsArrayElement) const;

	/**

	 * Retrieves the size of the structure.

	 * @param aInsideArray - whether the structure is part of an array or not. 

	 * @return byte count.

	 */

	virtual CSISFieldRoot::TFieldSize ByteCount (const bool aInsideArray) const;

	/**

	 * Sets the size of the structure.

	 * @param size - size of the structure. 

	 */

	virtual void SetByteCount (const CSISFieldRoot::TFieldSize aSize);

	/**

	 * Dump the entire content in hex format into the stream

	 */

	virtual void Dump (std::ostream& aStream, const int aLevel) const;

	/**

	 * Checks if the structure is required or not. Used for externalizing

	 * the class. If its a waste of space then we need not write this into

	 * the file.

	 */

	virtual bool WasteOfSpace () const;

	/**

	 * This function verifies the structure

	 * @param aLanguage - language

	 */ 

	virtual void Verify (const TUint32 aLanguages) const;

	/**

	 * Calculates CRC of the content

	 * @param aCRC CRC value of the content

	 * @param aIsArrayElement whether the structure is part of an array or not. 

	 */ 

	virtual void CalculateCrc (TCRC& aCRC, const bool aIsArrayElement) const;

	/**

	 * Class name

	 */

	virtual std::string Name () const;

	/**

	 * Named destructor. Deletes the buffer and resets the state.

	 */

	void Dispose ();

	/**

	 * Load the file into memory. 

	 * @param aFileName file name which needs to be loaded

	 * @param size file size.

	 */

	void Load (const std::wstring& aFileName, TUint64* size = NULL);

	/**

	 * @return data buffer  

	 */

	const TUint8* Data () const;

	/**

	 * @return data buffer  

	 */

	TUint8* Data ();

	/**

	 * Replace the existing data with this data.

	 * @param aData data pointer

	 * @param aSize size of data

	 */

	void Assign (const TUint8* aData, const CSISFieldRoot::TFieldSize aSize);

	/**

	 * Append the data after the existing data.

	 * @param aData data pointer

	 * @param aSize size of data

	 */

	void Append (const TUint8* aData, const CSISFieldRoot::TFieldSize aSize);

	/**

	 * Append the data before the existing data.

	 * @param aData data pointer

	 * @param aSize size of data

	 */

	void Prepend(const TUint8* aData, const CSISFieldRoot::TFieldSize aSize);

	/**

	 * Delete the previous content and allocate the new memory

	 * @param aData data pointer

	 * @param aSize size of data

	 */

	void Alloc (const CSISFieldRoot::TFieldSize aSize);

	/**

	 * Delete the previous content and allocate the new memory. 

	 * And also copy the content of the previous memory into the new memory

	 * @param aData data pointer

	 * @param aSize size of data

	 */

	void ReAlloc (const CSISFieldRoot::TFieldSize aSize);

	/**

	 * @return data size.

	 */

	TUint64 Size () const;

	/**

	 * Reset all the offset and data pointers. It does not delete any pointers.

	 * Can be used in ownership transfer.

	 */

	TUint8* GiveAway ();

	/**

	 * Compare the data for equality

	 */

 	bool operator==(const CBlob& aBlob) const;

	/**

	 * Adds the write the package details into the stream.

	 * @param aStream - Stream in which the package entries need to be written.

	 * @param aVerbose - If this option is set then detail description of pkg

	 * 			will be written into the stream.

	 */

private:

	void Duplicate (const CBlob <FieldType>& aInitialiser);

private:

	TUint8*						iData;

	CSISFieldRoot::TFieldSize	iSize;

	};

template <CSISFieldRoot::TFieldType FieldType> inline

		CBlob <FieldType>::CBlob () :

			iData (NULL),

			iSize (0)

	{

	}

template <CSISFieldRoot::TFieldType FieldType> inline

		CBlob <FieldType>::CBlob (const CBlob <FieldType>& aInitialiser)	:

			CSISField <FieldType> (aInitialiser),

			iData (NULL),

			iSize (0)

	{

	Duplicate (aInitialiser); 

	}

template <CSISFieldRoot::TFieldType FieldType> inline

		void CBlob <FieldType>::Alloc (const CSISFieldRoot::TFieldSize aSize)

	{

	if (iSize != aSize)

		{

		Dispose ();

		if (aSize != 0)

			{

			iData = new TUint8 [aSize]; 

			iSize = aSize;

			memset (iData, 0, iSize);

			}

		}

	}

template <CSISFieldRoot::TFieldType FieldType> inline

		void CBlob <FieldType>::ReAlloc (const CSISFieldRoot::TFieldSize aSize)

	{

	if (aSize <= iSize)

		{

		return;

		}

	if (aSize == 0)

		{

		Dispose ();

		}

	else

		{

		TUint8* data = new TUint8 [aSize];

		if (aSize > iSize)

			{

			memset (&data [iSize], 0, aSize - iSize);

			}

		memcpy (data, iData, std::min (aSize, iSize));

		Dispose ();

		iData = data;

		iSize = aSize;

		}

	}

template <CSISFieldRoot::TFieldType FieldType>

		void CBlob <FieldType>::Duplicate (const CBlob <FieldType>& aInitialiser)

	{

	try

		{

		Assign (aInitialiser.iData, aInitialiser.iSize);

		}

	catch (...)

		{

		iSize = 0;

		delete iData;

		iData = NULL;

		}

	}

template <CSISFieldRoot::TFieldType FieldType> inline

		CBlob <FieldType>::~CBlob ()

	{

	Dispose ();

	}

template <CSISFieldRoot::TFieldType FieldType>

		void CBlob <FieldType>::Dispose ()

	{

	delete [] iData;

	iData = NULL;

	iSize = 0;

	}

template <CSISFieldRoot::TFieldType FieldType>

		void CBlob <FieldType>::Read (TSISStream& aFile, const TUint64& aContainerSize, const CSISFieldRoot::TFieldType aArrayType)

	{

	CSISHeader header (aArrayType);

	header.Read (aFile, aContainerSize, aArrayType);

	SetByteCount (header.DataSize ());

	if (! WasteOfSpace ())

		{

		assert (! IsBadWritePtr (iData, iSize));

		aFile.read (iData, iSize);

		ReadFiller (aFile);

		}

	}

template <CSISFieldRoot::TFieldType FieldType>

		void CBlob <FieldType>::Write (TSISStream& aFile, const bool aIsArrayElement) const

	{

	if (! WasteOfSpace ())

		{

#ifdef GENERATE_ERRORS

		if (CSISFieldRoot::IsBugToBeCreated (CSISFieldRoot::EBugInsaneBlob))

			{

			CSISHeader (FieldType, rand ()).Write (aFile, aIsArrayElement);

			}

		else

#endif // GENERATE_ERRORS

			{

			CSISHeader (FieldType, ByteCount (false)).Write (aFile, aIsArrayElement);

			}

		assert (! IsBadReadPtr (iData, iSize));

		aFile.write (iData, iSize);

		WriteFiller (aFile);

		}

	}

template <CSISFieldRoot::TFieldType FieldType> inline

		CSISFieldRoot::TFieldSize CBlob <FieldType>::ByteCount (const bool aInsideArray) const

	{

	return iSize;

	}

template <CSISFieldRoot::TFieldType FieldType> inline

		void CBlob <FieldType>::SetByteCount (const CSISFieldRoot::TFieldSize aSize)

	{

	Alloc (aSize);

	}

template <CSISFieldRoot::TFieldType FieldType>

		void CBlob <FieldType>::Dump (std::ostream& aStream, const int aLevel) const

	{

	aStream << iSize << ": ";

	const TUint64 size = 20;

	for (unsigned index = 0; index < std::min (size, iSize); index++)

		{

#define HEX(x) (((x)<10)?((x)+'0'):((x)-10+'A'))

		aStream << static_cast <char> (HEX ((iData [index] >> 4) & 0xF));

		aStream << static_cast <char> (HEX (iData [index] & 0xF));

#undef HEX

		}

	if (20 < iSize)

		{

		aStream << "...";

		}

	}

template <CSISFieldRoot::TFieldType FieldType> inline

		bool CBlob <FieldType>::WasteOfSpace () const

	{

	return ! Required () && (iSize == 0);

	}

template <CSISFieldRoot::TFieldType FieldType> inline

		void CBlob <FieldType>::Verify (const TUint32 aLanguages) const

	{

	assert ((! iData) == (! iSize));

	}

template <CSISFieldRoot::TFieldType FieldType>

		void CBlob <FieldType>::CalculateCrc (TCRC& aCRC, const bool aIsArrayElement) const

	{

	if(!WasteOfSpace())

		{

		CSISHeader (CSISFieldRoot::ESISBlob, iSize).CalculateCrc (aCRC, aIsArrayElement); 

		CSISFieldRoot::DoPaddedCrc (aCRC, iData, iSize);

		}

	}

template <CSISFieldRoot::TFieldType FieldType>

		void CBlob <FieldType>::Load (const std::wstring& aFileName, TUint64* aSize)

	{

	TUint64 blobSize;

	HANDLE file = OpenFileAndGetSize (aFileName, &blobSize);

	SetByteCount (blobSize);

	ReadAndCloseFile (file, blobSize, iData);

	if (aSize)

		{

		*aSize = blobSize;

		}

	}

template <CSISFieldRoot::TFieldType FieldType> inline

		std::string CBlob <FieldType>::Name () const

	{

	return "Binary";

	}

template <CSISFieldRoot::TFieldType FieldType> inline

		const TUint8* CBlob <FieldType>::Data () const

	{

	return iData;

	}

template <CSISFieldRoot::TFieldType FieldType> inline

		TUint8* CBlob <FieldType>::Data ()

	{

	return iData;

	}

template <CSISFieldRoot::TFieldType FieldType> 

		void CBlob <FieldType>::Assign (const TUint8* aData, const CSISFieldRoot::TFieldSize aSize)

	{

	Alloc (aSize);

	if (aSize != 0)

		{

		memcpy (iData, aData, iSize);

		}

	}

template <CSISFieldRoot::TFieldType FieldType> 

		void CBlob <FieldType>::Append (const TUint8* aData, const CSISFieldRoot::TFieldSize aSize)

	{

	CSISFieldRoot::TFieldSize oldSize = iSize;

	ReAlloc (aSize + iSize);

	if (aSize > 0)

		{

		memcpy (&iData [oldSize], aData, aSize);

		}

	}

template <CSISFieldRoot::TFieldType FieldType>

		void CBlob <FieldType>::Prepend (const TUint8* aData, const CSISFieldRoot::TFieldSize aSize)

	{

	if (aSize > 0)

		{

		TUint8* data = new TUint8[iSize + aSize];

		memcpy(data, aData, aSize);

		memcpy(&(data[aSize]), iData, iSize);

		CSISFieldRoot::TFieldSize oldSize = iSize;

		Dispose();

		iData = data;

		iSize = aSize + oldSize;

		}

	}

template <CSISFieldRoot::TFieldType FieldType> 

		TUint8* CBlob <FieldType>::GiveAway ()

	{

	TUint8* data = iData;

	iData = NULL;

	iSize = 0;

	return data;

	}

template <CSISFieldRoot::TFieldType FieldType> inline

		TUint64 CBlob <FieldType>::Size () const

	{

	return iSize;

	}

template <CSISFieldRoot::TFieldType FieldType> inline

		bool CBlob <FieldType>::operator==(const CBlob& aBlob) const

	{

	// Return false if the size of the data in each blob doesn't match.				 	

	if (iSize != aBlob.iSize)

		{			  

		return false;

		}

	// Compare the data 

	return (!(memcmp(iData, aBlob.iData, iSize )));

	}

template <CSISFieldRoot::TFieldType FieldType> inline

	{

	if(aVerbose)

		{

		aStream << std::hex;

		for (TUint32 i=0; i<iSize; i++)

			{

			aStream.fill('0');

			aStream.width(2);

			aStream << (iData[i] & 0xFF);

			}

		aStream.width(0);

		aStream << std::dec;

		}

	}

#endif // __SISBLOB_H__