[TASK] Moved the project to namespaces.

[TASK] Removed all the protocol handlers. [TASK] Clients are no longer part of the SocketFramework itself. [TASK] The Framework provides an "interface" to external clients - the ClientDispatcher. [TASK] Added the Core package and added a better ClassLoader. [TASK] Created a bootstrap module to include in other projects. [TASK] Cleaned up comments, reformatted them.
2011-12-03 12:43:43 +01:00
parent 8de6bb29b6
commit 16ff75eb1d
32 changed files with 573 additions and 541 deletions
@@ -0,0 +1,74 @@
+<?php
+namespace JPT\SocketFramework\Client;
+
+/**
+ * Interface that includes the real must-have stuff.
+ * 
+ * @author jpt
+ * @interface
+ * @package Client
+ */
+interface ClientDispatcherInterface {
+
+	/**
+	 * 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 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();
+	
+	/**
+	 * Sets the ID.
+	 * 
+	 * @param int $id
+	 * @return void
+	 */
+	public function setID($id);
+	
+	/**
+	 * Sets the group.
+	 * 
+	 * @param string $group
+	 * @return void
+	 */
+	public function setGroup($group);
+	
+	/**
+	 * Injects ClientManager.
+	 * 
+	 * @param \JPT\SocketFramework\Client\ClientManager $clientManager
+	 * @return void
+	 * @throws \JPT\SocketFramework\Exception\WrongDatatypeException
+	 */
+	public function injectClientManager($clientManager);
+	
+}
+?>