/*
* 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: 
* Declares entry classes for Software Components Registry interface.
*
*/


/**
 @file
 @internalComponent
 @released
*/

#ifndef SCRENTRIES_INTERNAL_H
#define SCRENTRIES_INTERNAL_H

#include <e32base.h>
#include <s32strm.h>
#include <f32file.h> 
#include <usif/usifcommon.h>
#include <usif/scr/screntries.h>

//class Usif::CLocalizableCommonData;
//class Usif::CScrLogEntry;

namespace Usif
	{
		class CLocalizableCommonData;
		NONSHARABLE_CLASS(CLocalizedSoftwareTypeName) : public CLocalizableCommonData
		/**
			This class contains localized software type names.
			Software type names are localizable names and transferred to the SCR 
			with the objects of this class.
			
			@internalTechnology
		 */
			{
		public:	
			/**
				Creates a localized software type name object.
				@param aName The name of the software type.
				@param aLocale The language code of the object's locale.
				@return A pointer to the newly allocated localized software type name object, if creation is successful.
			 */
			IMPORT_C static CLocalizedSoftwareTypeName* NewL(const TDesC& aName, TLanguage aLocale);
			
			/**
				Creates a localized software type name object.
				@param aName The name of the software type.
				@param aLocale The language code of the object's locale.
				@return A pointer to the newly allocated localized software type name object, if creation is successful.
						The pointer is also put onto the cleanup stack.
			 */
			IMPORT_C static CLocalizedSoftwareTypeName* NewLC(const TDesC& aName, TLanguage aLocale);
			
			/**
				Creates a localized software type name object from a stream.
				@param aStream The stream to read the localized software type name object from.
				@return A pointer to the newly allocated localized software type name object, if creation is successful.
				@internalComponent
			 */
			IMPORT_C static CLocalizedSoftwareTypeName* NewL(RReadStream& aStream);
			
			~CLocalizedSoftwareTypeName();
			
			/**
				Externalises a localized software type name object to a write stream.
				@param aStream The stream to which the object is externalised.
				@internalComponent
			 */
			IMPORT_C void ExternalizeL(RWriteStream& aStream) const;	
			
			/** @return The localized software type name. */
			IMPORT_C const TDesC& NameL() const;
			
		private:
			CLocalizedSoftwareTypeName();
			CLocalizedSoftwareTypeName(TLanguage aLocale);
			void ConstructL(const TDesC& aName);
			void InternalizeL(RReadStream& aStream);
			
		private:
			HBufC* iName;	   ///< The localized software type name.
			};
	
	NONSHARABLE_CLASS (CScrLogEntry) : public CBase
	/**
		Class that represents a software component log record generated by the SCR.
	 */ 
		{
		friend class CScrRequestImpl;
	public:
		/**
			Creates a log entry object.
			@param aComponentName The name of the component.
			@param aUniqueSwTypeName The non-localized, unique software type name, such as @see Usif::KSoftwareTypeNative and @see Usif::KSoftwareTypeJava.
			@param aGlobalId The global Id of the component.
			@param aVersion The version of the component.
			@param aCompOpType The type of the component operation. @see Usif::TScrComponentOperationType
			@return A pointer to the newly allocated log entry object, if creation is successful.
			@internalComponent
		 */
		IMPORT_C static CScrLogEntry* NewL(const TDesC& aComponentName, const TDesC& aUniqueSwTypeName, const TDesC& aGlobalId, const TDesC& aVersion, const TScrComponentOperationType aCompOpType);
		
		/**
			Creates a log entry object.
			@param aComponentName The name of the component.
			@param aUniqueSwTypeName The non-localized, unique software type name, such as @see Usif::KSoftwareTypeNative and @see Usif::KSoftwareTypeJava.
			@param aGlobalId The global Id of the component.
			@param aVersion The version of the component.
			@param aCompOpType The type of the component operation. @see Usif::TScrComponentOperationType
			@return A pointer to the newly allocated log entry object, if creation is successful.
					The pointer is also put onto the cleanup stack.
			@internalComponent		
		 */
		IMPORT_C static CScrLogEntry* NewLC(const TDesC& aComponentName, const TDesC& aUniqueSwTypeName, const TDesC& aGlobalId, const TDesC& aVersion, const TScrComponentOperationType aCompOpType);

	 	/**
	 		Creates a log entry object from a stream.
	 		@param aStream The stream to read the log entry object from.
	 		@return A pointer to the newly allocated log entry object, if creation is successful.
	 				The pointer is also put onto the cleanup stack.
	 		@internalComponent
	 	*/
		IMPORT_C static CScrLogEntry* NewLC(RReadStream& aStream);
		
		~CScrLogEntry();
		
	 	/**
		 	Write the object to a stream 
		 
		 	@param aStream The stream to write to
		 	@internalComponent
		 */
		IMPORT_C void ExternalizeL(RWriteStream& aStream) const;
		 
		/**
		 	Read the object from a stream
		 
		 	@param aStream The stream to read from.
		 	@internalComponent
		 */
		IMPORT_C void InternalizeL(RReadStream& aStream) ;
	    
	    /**
			@return The name of the component for which the log was generated.
		 */
		IMPORT_C const TDesC& ComponentName() const; 
		
		/**
			@return The non-localized, unique software type name, such as @see Usif::KSoftwareTypeNative and @see Usif::KSoftwareTypeJava.
		 */
		IMPORT_C const TDesC& SoftwareTypeName() const;
		
		/**
			The UID.
		 	@return The global ID of the component.
		 */
		IMPORT_C const TDesC& GlobalId() const; 
				
		/**
			@return The version of the component.
		 */
		IMPORT_C const TDesC& ComponentVersion() const; 
	    
		/**
			@return The time when the operation occured.
		 */
		IMPORT_C const TTime OperationTime() const; 
			    
	    /**
		    @return The type of the component operation for the log record.
		 */
		IMPORT_C TScrComponentOperationType OperationType() const;
		
		/**
			@return The component id of the log record.
			@internalComponent
		 */
		IMPORT_C TComponentId ComponentId() const;
	
	private:
		CScrLogEntry();
		void ConstructL(const TDesC& aComponentName, const TDesC& aUniqueSwTypeName, const TDesC& aGlobalId, const TDesC& aVersion, const TScrComponentOperationType aCompOpType);
		
	private:	
	    HBufC* iComponentName ;
	    HBufC* iSwTypeName;
		HBufC* iVersion;
		TScrComponentOperationType iOpType ; 
		TTime  iRecordTime ;   
		HBufC* iGlobalId;
		TComponentId iComponentId; 
		};
	
	} // End of namespace Usif

#endif // SCRENTRIES_H