- Se arregla un poco la documentacion y se pasa el Doxyfile a nivel general (no

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

diff --git a/Server/include/plaqui/server/connection.h b/Server/include/plaqui/server/connection.h
index ef1fa2491e209b6c6a3094ba31aec0c7f34fddf5..1eab7faf8a1dbbe969e23fd90ad7d7481d1bb4b3 100644 (file)
--- a/Server/include/plaqui/server/connection.h
+++ b/Server/include/plaqui/server/connection.h
@@ -31,49 +31,99 @@
 #include "plaqui/server/runnable.h"
 #include <socket++/sockinet.h>
 
-namespace Plaqui {
+namespace PlaQui {
+
+namespace Server {
 
        /// Conexión.
        class Connection: public Runnable {
 
-               protected:
+               // Tipos.
+
+               public:
 
-                       /// Tamaño del buffer usado para enviar y recibir datos.
-                       static const int BUFFER_SIZE = 4096;
+                       /// Puerto.
+                       typedef unsigned Port;
+
+               // Atributos.
+
+               protected:
 
                        /// Socket a usar en la conexión.
                        iosockinet socket;
 
+                       /// Host.
+                       std::string host;
+
+                       /// Puerto.
+                       Port port;
+
+                       /// Mutex para el socket.
+                       //Glib::Mutex socket_mutex;
+
+               // Métodos.
+
                public:
 
                        /**
                         * Destructor.
                         */
-                       virtual ~Connection(void) {}
+                       virtual ~Connection(void);
 
                        /**
                         * Constructor.
                         *
-                        * \param socket Descriptor de socket a usar en la conexión.
+                        * \param sd Descriptor de socket a usar en la conexión.
                         */
                        Connection(const sockbuf::sockdesc& sd);
 
                        /**
                         * Constructor.
                         *
-                        * \param socket Socket a usar en la conexión.
+                        * \param type Tipo de socket a usar.
+                        * \param host Host a donde conectarse.
+                        * \param port Puerto al cual conectarse.
                         */
-                       //Connection(const sockinetbuf& sb);
+                       Connection(const sockbuf::type& type, const std::string& host,
+                                       const Port& port);
 
                        /**
                         * Constructor.
                         *
-                        * \param type Tipo de socket a usar.
+                        * \param host Host a donde conectarse.
+                        * \param port Puerto al cual conectarse.
                         */
-                       Connection(sockbuf::type type);
+                       Connection(const std::string& host, const Port& port);
+
+                       /**
+                        * Finaliza la conexión.
+                        *
+                        * \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);
+
+                       /**
+                        * Obtiene el nombre del host local de la conexión.
+                        * \todo TODO - Debería devolver una copia? Porque podría morir la
+                        *       conexion y nosotros seguir usando la variable destruida.
+                        */
+                       const std::string& get_host(void) const;
+
+                       /**
+                        * Obtiene el puerto local de la conexión.
+                        * \todo TODO - Debería devolver una copia? Porque podría morir la
+                        *       conexion y nosotros seguir usando la variable destruida.
+                        */
+                       const Port& get_port(void) const;
 
        };
 
 }
 
+}
+
 #endif // PLAQUI_CONNECTION_H