<?php
/**
 * Abstract class that implements the basic api for any client.
 * @author jpt
 * @abstract
 * @package Client
 */
abstract class Client_AbstractClient {

	/**
	 * @var int
	 */
	protected $ID;

	/**
	 * @var string
	 */
	protected $group;

	/**
	 * @var mixed Instance of Protocol_AbstractProtocolHandler
	 */
	protected $protocolHandler;

	/**
	 * Contains a reference to the ClientManager in order to change stuff on the fly.
	 * @var Client_ClientManager
	 */
	protected $clientManager;

	/**
	 * Injects ProtocolHandler
	 * @param mixed $protocolHandler instance of Protocol_AbstractProtocolHandler
	 * @return void
	 * @throws Exception_WrongDatatypeException
	 */
	public function injectProtocolHandler($protocolHandler) {
		if(!$protocolHandler instanceof Protocol_AbstractProtocolHandler) {
			throw new Exception_WrongDatatypeException("Cannot inject ProtocolHandler! Expected an instance of Protocol_AbstractProtocolHandler, '" . get_type($protocolHandler) . "' given.", 1291156562);
		}
		$this->protocolHandler = $protocolHandler;
	}

	/**
	 * Forwards incoming data to the ProtocolHandler
	 * Let's the ProtocolHandler do all the work and forward its results to the Clients.
	 * Return resulting raw data.
	 * @param string $rawData
	 * @return string
	 */
	public function processRawData($rawData) {
		$this->protocolHandler->pushRawData($rawData);
		while($this->protocolHandler->canWork()) {
			$this->processContentObject($this->protocolHandler->work());
		}
		return $this->protocolHandler->getRawData();
	}

	/**
	 * This function will be the main entry point of any client.
	 * Any reactions will be passed to the ProtocolHandler.
	 * The ProtocolHandler will then pass the data back to the socket.
	 * @param string $data
	 * @return void
	 */
	abstract protected function processContentObject($contentObject);

	/**
	 * This function will load the given config.
	 * @param array $config
	 * @return void
	 */
	abstract public function loadConfig($config);

	/**
	 * Will reset the connectionStatus of the client.
	 * Implementation is optional and depends on the client.
	 * Should be used to reset internal variables.
	 * @return void
	 */
	public function resetConnectionStatus() {

	}

	/**
	 * This function gets called every time, the connection is established.
	 * This allows the client to send initial data.
	 * @return void
	 */
	public function initializeConnection() {

	}

	/**
	 * @param int $id
	 * @return void
	 */
	public function setID($id) {
		$this->ID = $id;
	}

	/**
	 * @param string $group
	 * @return void
	 */
	public function setGroup($group) {
		$this->group = $group;
	}

	/**
	 * Injects ClientManager
	 * @param Client_ClientManager $clientManager
	 * @return void
	 * @throws Exception_WrongDatatypeException
	 */
	public function injectClientManager($clientManager) {
		if(!$clientManager instanceof Client_ClientManager) {
			throw new Exception_WrongDatatypeException("Cannot inject ClientManager! Expected an instance of Client_ClientManager, '" . get_type($clientManager) . "' given.", 1291156565);
		}
		$this->clientManager = $clientManager;
	}
}
?>