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

//

#ifndef __SERVERCONSOLE_H__

#define __SERVERCONSOLE_H__

#include <e32std.h>

#include <e32base.h>

#include <e32cons.h>

#include <testframework.h>

/**

 *

 * Console reader mixin class.

 * Any main program or class using a CServerConsole

 * should implement this class.

 *

 * @xxxx

 *

 */

class MConsoleReader

	{

public:

/**

 *

 * Processes a received keystroke.

 *

 * @param	"TKeyCode aKeystroke"

 *			The received keystroke.

 *

 * @xxxx 

 *

 */

	virtual void InputReceived(TKeyCode aKeystroke) = 0;

/**

 *

 * Handles console reader errors.

 *

 * @param	"TInt aError"

 *			The error code.

 *

 * @xxxx 

 *

 */

	virtual void Error(TInt aError) = 0;

	};

/**

 *

 * Keystroke reader for CServerConsole.

 *

 *

 * @xxxx

 *

 */

class CConsoleReader : public CActive

	{

public:

	static CConsoleReader* NewL(CConsoleBase& aConsole);

	~CConsoleReader();

	void DoRead(MConsoleReader& aClient);

	void DoRead();//keeping same client as before

	void RunL();

protected:

	void DoCancel();

private:

	CConsoleReader(CConsoleBase& aConsole);

private:

	MConsoleReader* iClient;

	CConsoleBase& iConsole;

	TKeyCode iKeyStroke;

	};

/**

 *

 * Active console for test input.

 * To be used where manual control of testing is required

 *

 * @xxxx

 *

 */

class CServerConsole : public CActive

	{

public:

	static CServerConsole* NewL(const TDesC& aName);

	~CServerConsole();

	void SetInstructionsL(const TDesC& aInstructions);

	void Read(MConsoleReader& aReader);

	void ReadCancel();

	void RunL();

	void DoCancel();

	TInt RunError(TInt aError);

	// accessor

	CConsoleBase* Console() const;

private:

	CServerConsole();

	void ConstructL(const TDesC& aName);

private:

	CConsoleBase* iConsole;

	TRectBuf iWindow;

	HBufC* iWindowName;

	HBufC* iInstructions;

	CConsoleReader* iConsoleReader;

	};

#endif // __SERVERCONSOLE_H__