// 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:
//

#include "ServerConsole.h"


/**
 *
 * Static constructor for CServerConsole.
 *
 * @param	"const TDesC& aName"
 *			Display name for console
 *
 * @return	"CServerConsole*"
 *			The constructed CServerConsole
 *
 * @xxxx 
 *
 */
CServerConsole* CServerConsole::NewL(const TDesC& aName)
	{
	CServerConsole* s = new(ELeave) CServerConsole;
	CleanupStack::PushL(s);
	s->ConstructL(aName);
	CleanupStack::Pop();
	return s;
	}

/**
 *
 * Destructor for CServerConsole.
 * Destroys display console and its reader
 *
 * @xxxx
 *
 */
CServerConsole::~CServerConsole()
	{
	Cancel();
	delete iConsoleReader;
	delete iWindowName;
	delete iInstructions;
	delete iConsole;
	}

/**
 *
 * First-phase constructor for CServerConsole.
 * Adds itself to the Active Scheduler.
 *
 * @xxxx
 *
 */
CServerConsole::CServerConsole()
	:CActive(EPriorityHigh)
	{
	CActiveScheduler::Add(this);
	}

/**
 *
 * Second-phase constructor for CServerConsole.
 * Creates the display console and its reader.
 *
 * @param	"const TDesC& aName"
 *			Display name of console.
 *
 * @xxxx
 *
 */
void CServerConsole::ConstructL(const TDesC& aName)
	{
	iWindowName = aName.AllocL();
	iConsole =  Console::NewL(*iWindowName, TSize(KConsFullScreen,KConsFullScreen));
	iConsoleReader = CConsoleReader::NewL(*iConsole);
	}

/**
 *
 * Accessor for base console.
 *
 * @return	"CConsoleBase*"
 *			The base console.
 *
 * @xxxx 
 *
 */
CConsoleBase* CServerConsole::Console() const
	{
	return iConsole;
	}

/**
 *
 * Sets and shows displayable instructions.
 *
 * @param	"const TDesC& aInstructions"
 *			Displayable instruction string.
 *
 * @xxxx 
 *
 */
void CServerConsole::SetInstructionsL(const TDesC& aInstructions)
	{
	if (iInstructions)
		{
		delete iInstructions;
		iInstructions = NULL;
		}
	iInstructions = aInstructions.AllocL();
	iConsole->ClearScreen();
	iConsole->Write(*iInstructions);
	}

/**
 *
 * Starts the console reader listening for input.
 *
 * @param	"MConsoleReader& aReader"
 *			The console reader.
 *
 * @xxxx 
 *
 */
void CServerConsole::Read(MConsoleReader& aReader)
	{
	iConsoleReader->DoRead(aReader);
	}

/**
 *
 * Stops the console reader listening for input.
 *
 *
 * @xxxx 
 *
 */
void CServerConsole::ReadCancel()
	{
	iConsoleReader->Cancel();
	}

/**
 *
 * RunL method for active object CServerConsole.
 *
 * @xxxx
 *
 */
void CServerConsole::RunL()
	{
	User::LeaveIfError(iStatus.Int());
	TBool reading = iConsoleReader->IsActive();
	iConsoleReader->Cancel();

	//listen for key input if we were before...
	if (reading)
		iConsoleReader->DoRead();
	}

/**
 *
 * DoCancel method for active object CServerConsole.
 *
 * @xxxx
 *
 */
void CServerConsole::DoCancel()
	{
	ReadCancel();
	}

/**
 *
 * Error handler for active object CServerConsole.
 * (Currently a stub)
 *
 * @param	"TInt aError"
 *			The error code
 *
 * @return	"TInt"
 *			The error code
 *
 * @xxxx
 *
 */
TInt CServerConsole::RunError(TInt aError)
	{
	return aError;
	}



/**
 *
 * Static constructor for CConsoleReader.
 *
 * @param	"CConsoleBase& aConsole"
 *			The console we are to read
 *
 * @return	"CConsoleReader*"
 *			The constructed CConsoleReader
 *
 * @xxxx
 *
 */
CConsoleReader* CConsoleReader::NewL(CConsoleBase& aConsole)
	{
	CConsoleReader* s = new(ELeave) CConsoleReader(aConsole);
	return s;
	}

/**
 *
 * First-phase constructor for CConsoleReader.
 * Adds itself to the Active Scheduler.
 *
 * @param	"CConsoleBase& aConsole"
 *			console to read from
 *
 * @xxxx
 *
 */
CConsoleReader::CConsoleReader(CConsoleBase& aConsole) :
	CActive(EPriorityUserInput),
	iConsole(aConsole)
	{
	CActiveScheduler::Add(this);
	}

/**
 *
 * Destructor for CConsoleReader.
 *
 * @xxxx
 *
 */
CConsoleReader::~CConsoleReader()
	{
	Cancel();
	}

/**
 *
 * DoRead method for active object CConsoleReader;
 * sets client and starts reading
 *
 * @param	"MConsoleReader& aClient"
 *			client MConsoleReader (which will process the input)
 *
 * @xxxx
 *
 */
void CConsoleReader::DoRead(MConsoleReader& aClient)
	{
	iClient = &aClient;
	DoRead();
	}

/**
 *
 * DoRead method for active object CConsoleReader;
 * starts reading from current client
 *
 * @xxxx
 *
 */
void CConsoleReader::DoRead()
	{
	iConsole.Read(iStatus);
	SetActive();
	}

/**
 *
 * RunL method for active object CConsoleReader;
 * fetches a keystroke and sends it to its client for processing.
 *
 * @xxxx
 *
 */
void CConsoleReader::RunL()
	{
	iKeyStroke = iConsole.KeyCode();
	if (iStatus.Int())
		iClient->Error(iStatus.Int());
	else
		iClient->InputReceived(iKeyStroke);
	}

/**
 *
 * DoCancel method for active object CConsoleReader
 *
 * @xxxx
 *
 */
void CConsoleReader::DoCancel()
	{
	iConsole.ReadCancel();
	}