Se actualiza documentacion:

[z.facultad/75.42/plaqui.git] / Server / include / plaqui / server / tcpserver.h

diff --git a/Server/include/plaqui/server/tcpserver.h b/Server/include/plaqui/server/tcpserver.h
index 1cd344f4da3599eea86ddade2da09cfc7df9783c..5277f2bf188d2b9fb4c867495c518bfcf7c743ab 100644 (file)
--- 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>
 
@@ -44,6 +45,7 @@ namespace Server {
         */
        class TCPServer: public Runnable {
 
+               /////////////////////////////////////////////////////////////////////
                // Constantes.
 
                private:
@@ -51,6 +53,7 @@ namespace Server {
                        /// Cantidad máxima de conexiones pendientes.
                        static const unsigned MAX_PENDING_CONNECTIONS = 10;
 
+               /////////////////////////////////////////////////////////////////////
                // Tipos.
 
                private:
@@ -65,25 +68,47 @@ namespace Server {
                                /// Host.
                                std::string host;
                                /// Port.
-                               unsigned port;
+                               Connection::Port port;
                        };
 
                        /// 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;
 
-                       /// Mutex para las conexiones.
-                       Glib::Mutex connections_mutex;
+               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 +116,7 @@ namespace Server {
                        /**
                         * Entra en el loop para atender conexiones.
                         */
-                       virtual void real_run(void);
+                       virtual void real_run(void) throw();
 
                protected:
 
@@ -116,7 +141,15 @@ namespace Server {
                         *
                         * \param port Puerto en el cual escuchar.
                         */
-                       TCPServer(int port);
+                       TCPServer(const Connection::Port& port) throw(sockerr);
+
+                       /**
+                        * Finaliza la tarea.
+                        *
+                        * \note Para saber cuando la tarea fue finalizada puede utilizar
+                        *       la señal signal_finished().
+                        */
+                       virtual void finish(void);
 
                        /**
                         * Se encarga de borrar una conexión de la lista cuando finaliza.
@@ -125,6 +158,12 @@ namespace Server {
                         */
                        void on_connection_finished(Connection* connection);
 
+                       /**
+                        * Detiene una conexión.
+                        */
+                       bool disconnect(const std::string& host,
+                                       const Connection::Port& port);
+
                        /**
                         * Obtiene una lista conexiones de control abiertas.
                         */