Server/include/plaqui/server/server.h

   1 // vim: set noexpandtab tabstop=4 shiftwidth=4:
   2 //----------------------------------------------------------------------------
   3 //                                  PlaQui
   4 //----------------------------------------------------------------------------
   5 // This file is part of PlaQui.
   6 //
   7 // PlaQui is free software; you can redistribute it and/or modify it under the
   8 // terms of the GNU General Public License as published by the Free Software
   9 // Foundation; either version 2 of the License, or (at your option) any later
  10 // version.
  11 //
  12 // PlaQui is distributed in the hope that it will be useful, but WITHOUT ANY
  13 // WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
  14 // FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
  15 // details.
  16 //
  17 // You should have received a copy of the GNU General Public License along
  18 // with PlaQui; if not, write to the Free Software Foundation, Inc., 59 Temple
  19 // Place, Suite 330, Boston, MA  02111-1307  USA
  20 //----------------------------------------------------------------------------
  21 // Creado:  Sat Oct 18 18:18:36 2003
  22 // Autores: Leandro Lucarella <llucare@fi.uba.ar>
  23 //----------------------------------------------------------------------------
  24 //
  25 // $Id$
  26 //
  27
  28 #ifndef PLAQUI_SERVER_H
  29 #define PLAQUI_SERVER_H
  30
  31 #include "plaqui/server/tcpserver.h"
  32 #include "plaqui/server/controlserver.h"
  33 #include "plaqui/server/transmitter.h"
  34 #include "plaqui/server/plant.h"
  35 #include "plaqui/server/command.h"
  36 #include <socket++/sockinet.h>
  37 #include <string>
  38 #include <list>
  39
  40 namespace PlaQui {
  41
  42 namespace Server {
  43
  44         /**
  45          * Servidor de plantas químicas.
  46          * Maneja múltiples conexiones, de control o de transmisión.
  47          */
  48         class Server: public TCPServer {
  49
  50                 // Tipos.
  51
  52                 private:
  53
  54                         /// Lista de conexiones de control.
  55                         typedef std::list<Transmitter*> TransmitterList;
  56
  57                         /// Lista de plantas químicas.
  58                         typedef std::list<Plant*> PlantList;
  59
  60                 // Atributos.
  61
  62                 private:
  63
  64                         /// Transmisiones del estado de las plantas.
  65                         TransmitterList transmissions;
  66
  67                         /// Mutex para las transmisiones.
  68                         Glib::Mutex transmissions_mutex;
  69
  70                         // Plantas disponibles en el servidor.
  71                         PlantList plants;
  72
  73                         /// Mutex para las plantas.
  74                         Glib::Mutex plants_mutex;
  75
  76                 // Métodos.
  77
  78                 protected:
  79
  80                         /**
  81                          * Obtiene una nueva \ref Connection "conexión".
  82                          *
  83                          * \param sd Descriptor del socket de la nueva conexión.
  84                          *
  85                          * \return Nueva conexión.
  86                          */
  87                         virtual Connection* new_connection(const sockbuf::sockdesc& sd);
  88
  89                         /**
  90                          * Maneja el comando server/status.
  91                          */
  92                         HTTPResponse* cmd_server_status(void) const;
  93
  94                         /**
  95                          * Maneja el comando connection/list.
  96                          */
  97                         HTTPResponse* cmd_connection_list(void);
  98
  99                         /**
 100                          * Maneja el comando connection/stop.
 101                          */
 102                         HTTPResponse* cmd_connection_stop(const Command& command);
 103
 104                 public:
 105
 106                         /**
 107                          * Destructor.
 108                          */
 109                         virtual ~Server(void);
 110
 111                         /**
 112                          * Constructor.
 113                          *
 114                          * \param port Puerto en el cual escuchar.
 115                          */
 116                         Server(int port = 7522);
 117
 118                         /**
 119                          * Comienza la transimisión del estado de una planta.
 120                          *
 121                          * \param host Host al cual se quiere transmitir.
 122                          * \param port Puerto al cual transmitir.
 123                          *
 124                          * \return true si se pudo empezar a transmitir, false si no.
 125                          *
 126                          * \todo Ver si es necesario que devuelva algo y si devuelve ver si
 127                          *       no sería mejor que dé más información (si no se pudo abrir
 128                          *       o si ya estaba abierto por ejemplo.
 129                          */
 130                         bool start_transmission(std::string host = "localhost",
 131                                         int port = 7528);
 132
 133                         /**
 134                          * Finaliza la transimisión del estado de una planta.
 135                          *
 136                          * \param host Host al cual se quiere dejar de transmitir.
 137                          * \param port Puerto al cual dejar de transmitir.
 138                          *
 139                          * \return true si se pudo empezar a transmitir, false si no.
 140                          *
 141                          * \todo Ver de hacer un TransmissionManager.
 142                          */
 143                         bool stop_transmission(std::string host, int port);
 144
 145                         /**
 146                          * Maneja los comandos recibidos por las conexiones.
 147                          */
 148                         void on_control_command_received(const Command& command,
 149                                         ControlServer* controlserver);
 150
 151         };
 152
 153 }
 154
 155 }
 156
 157 #endif // PLAQUI_SERVER_H