Se corrige documentacion y se agrega la pagina relacionada sobre el server

[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..7eda17226a1e882a09e967f9e5b7f80081fb4ed5 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>
 
 #include "plaqui/server/runnable.h"
 #include <socket++/sockinet.h>
 

-namespace Plaqui {
+namespace PlaQui {
+
+namespace Server {

 
        /// Conexión.
        class Connection: public Runnable {
 
 
        /// 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;
 
 
                        /// 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.
                         */
                public:
 
                        /**
                         * Destructor.
                         */

-                       virtual ~Connection(void) {}
+                       virtual ~Connection(void);

 
                        /**
                         * Constructor.
                         *
 
                        /**
                         * 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.
                         *
                         */
                        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.
                         *
 
                        /**
                         * 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.
+                        *
+                        * \note Para saber cuando la tarea fue finalizada puede utilizar
+                        *       la señal signal_finished().
+                        */
+                       virtual void finish(void);
+
+                       /**
+                        * 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 
 #endif // PLAQUI_CONNECTION_H