/*
* Copyright (c) 2006-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: 
* Software random implementation
*
*/


/**
 @file
 @internalComponent
 @released
*/

#ifndef __CRYPTOAPI_RANDOMIMPL_H__
#define __CRYPTOAPI_RANDOMIMPL_H__

#include <cryptospi/cryptoplugin.h>
#include <cryptospi/randomplugin.h>

namespace SoftwareCrypto
	{
	using namespace CryptoSpi;
	
	NONSHARABLE_CLASS(CRandomImpl): public CBase, public MRandom
		{
	public:
		// NewL & NewLC
		static CRandomImpl* NewL();
		static CRandomImpl* NewLC();
		
		// From MPlugin
		void Reset();
		void Close();
		void GetCharacteristicsL(const TCharacteristics*& aPluginCharacteristics);
		const CExtendedCharacteristics* GetExtendedCharacteristicsL();
		TAny* GetExtension(TUid aExtensionId);
		TUid ImplementationUid() const;
		
		// From MRandom
		void GenerateRandomBytesL(TDes8& aDest);
		
		static CExtendedCharacteristics* CreateExtendedCharacteristicsL();
		
	private:
		//Constructor
		CRandomImpl();
		
		//Destructor
		~CRandomImpl();
		
	private:
		TUid iImplementationUid;
		};

	class TRandomImpl 
	/**
	 * The user interface to the system cryptographically 
	 * secure random number generator.
	 *
	 * @internalComponent
	 * @released
	 */
		{
	public:
		
		/**
		 * Fills the provided buffer with secure random data up to its
		 * current length, discarding any current content.
		 *
		 * @param aDestination The buffer in which to write the random data.
		 */
		static void Random(TDes8& aDestination);
		};
	
	class RRandomSessionImpl : public RSessionBase
	/**
	 * The client interface to the system random number generator. End
	 * users should use TRandom instead of this interface.
	 *
	 * @internalAll
	 * @released
	 */
		{
	public:
		RRandomSessionImpl();
		
		/**
		 * Fills the provided buffer with secure random data up to its
		 * current length, discarding any current content.
		 *
		 * @param aDestination The buffer in to which to write the random data 
		 */
		TInt GetRandom(TDes8& aDestination);
		
		/**
		 * Opens a new session with the random number server.
		 */
		void ConnectL();
		};
	}

#endif // __CRYPTOAPI_RANDOMIMPL_H__