X-Git-Url: https://git.llucax.com/z.facultad/75.42/plaqui.git/blobdiff_plain/7e74b790d290cd7d776349503bb361c47933c01f..9322e49b932d824e5664aa8c0e0f9a41464537b1:/Server/include/plaqui/server/tcpserver.h?ds=inline

diff --git a/Server/include/plaqui/server/tcpserver.h b/Server/include/plaqui/server/tcpserver.h
index a64b545..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,11 +40,29 @@ 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 {
 
+		/////////////////////////////////////////////////////////////////////
 		// Constantes.
 
 		private:
@@ -51,6 +70,7 @@ namespace Server {
 			/// Cantidad máxima de conexiones pendientes.
 			static const unsigned MAX_PENDING_CONNECTIONS = 10;
 
+		/////////////////////////////////////////////////////////////////////
 		// Tipos.
 
 		private:
@@ -71,19 +91,41 @@ 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.
 
-		private:
+		protected:
 
 			/// Socket para escuchar conexiones.
 			sockinetbuf socket;
 
+		private:
+
+			/// Señal que indica que se inició una conexión.
+			SignalConnectionOpened _connection_opened;
+
 			/// Conexiones de control.
 			ConnectionList connections;
 
 			/// Mutex para las conexiones.
 			Glib::Mutex connections_mutex;
 
+		/////////////////////////////////////////////////////////////////////
 		// Métodos.
 
 		private:
@@ -91,7 +133,7 @@ namespace Server {
 			/**
 			 * Entra en el loop para atender conexiones.
 			 */
-			virtual void real_run(void);
+			virtual void real_run(void) throw();
 
 		protected:
 
@@ -121,13 +163,10 @@ namespace Server {
 			/**
 			 * Finaliza la tarea.
 			 *
-			 * \param attach Si es true, la función no retorna hasta que no
-			 *               finalice la tearea (no recomendable).
-			 *
 			 * \note Para saber cuando la tarea fue finalizada puede utilizar
 			 *       la señal signal_finished().
 			 */
-			//virtual void finish(bool attach = false);
+			virtual void finish(void);
 
 			/**
 			 * Se encarga de borrar una conexión de la lista cuando finaliza.