X-Git-Url: https://git.llucax.com/z.facultad/75.42/plaqui.git/blobdiff_plain/212f9ae5dc8899bab8b23ed13d81c28c510db3c3..9322e49b932d824e5664aa8c0e0f9a41464537b1:/Server/include/plaqui/server/tcpserver.h

diff --git a/Server/include/plaqui/server/tcpserver.h b/Server/include/plaqui/server/tcpserver.h
index d94918e..368594e 100644
--- a/Server/include/plaqui/server/tcpserver.h
+++ b/Server/include/plaqui/server/tcpserver.h
@@ -31,6 +31,7 @@
 #include "plaqui/server/runnable.h"
 #include "plaqui/server/connection.h"
 #include <socket++/sockinet.h>
+#include <sigc++/signal.h>
 #include <list>
 #include <vector>
 
@@ -39,8 +40,25 @@ namespace PlaQui {
 namespace Server {
 
 	/**
-	 * Servidor de plantas químicas.
-	 * Maneja muchas conexiones, de control o de transmisión.
+	 * Servidor genéríco TCP/IP.
+	 *
+	 * Maneja muchas conexiones, en threads. En términos generales todo lo que
+	 * hace es algo parecido a esto:
+	 * \code
+	 * while (!stop) {
+	 *     Connection* conexion = new_connection(accept());
+	 *     connections.push_back(conexion);
+	 * }
+	 * \endcode
+	 *
+	 * new_connection() es un método virtual puro que hay que definir en las
+	 * subclases para hacer un servidor específico que trabaje con un protocolo
+	 * determinado. new_connection() devuelve un puntero a una
+	 * \ref Connection "conexión".
+	 *
+	 * on_connection_finished() maneja la
+	 * \ref Runnable::signal_finished "señal para indicar que una conexión terminó"
+	 * para eliminarla de la \ref connections "lista de conexiones".
 	 */
 	class TCPServer: public Runnable {
 
@@ -73,14 +91,33 @@ namespace Server {
 			/// Lista de información de conexiones de control.
 			typedef std::vector<ConnectionInfo> ConnectionInfoList;
 
+		/////////////////////////////////////////////////////////////////////
+		/// \name Señales
+		//@{
+
+		public:
+
+			/// Tipo de señal para indicar que se inició una conexión.
+			typedef SigC::Signal2<void, const std::string&,
+					const Connection::Port&> SignalConnectionOpened;
+
+			/// Obtiene la señal que avisa que se inició una conexión.
+			SignalConnectionOpened& signal_connection_opened(void);
+
+		//@}
+
 		/////////////////////////////////////////////////////////////////////
 		// Atributos.
 
-		protected: //FIXME
+		protected:
 
 			/// Socket para escuchar conexiones.
 			sockinetbuf socket;
-		private: // FIXME
+
+		private:
+
+			/// Señal que indica que se inició una conexión.
+			SignalConnectionOpened _connection_opened;
 
 			/// Conexiones de control.
 			ConnectionList connections;
@@ -96,7 +133,7 @@ namespace Server {
 			/**
 			 * Entra en el loop para atender conexiones.
 			 */
-			virtual void real_run(void);
+			virtual void real_run(void) throw();
 
 		protected:
 
@@ -129,7 +166,7 @@ namespace Server {
 			 * \note Para saber cuando la tarea fue finalizada puede utilizar
 			 *       la señal signal_finished().
 			 */
-			//virtual void finish(void);
+			virtual void finish(void);
 
 			/**
 			 * Se encarga de borrar una conexión de la lista cuando finaliza.