Server/include/plaqui/server/controlclient.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_CONTROLCLIENT_H
  29 #define PLAQUI_CONTROLCLIENT_H
  30
  31 #include "plaqui/server/command.h"
  32 #include "plaqui/server/connection.h"
  33 #include "plaqui/server/receiver.h" // TODO TEMPRORAL
  34 #include <string>
  35
  36 namespace PlaQui {
  37
  38 namespace Server {
  39
  40         /// Conexión para enviar comandos de control a una planta.
  41         class ControlClient: public Connection {
  42
  43                 /////////////////////////////////////////////////////////////////////
  44                 // Tipos.
  45
  46                 public:
  47
  48                 /////////////////////////////////////////////////////////////////////
  49                 /// \name Señales.
  50                 //@{
  51
  52                 public:
  53
  54                         /// Tipo de señal para indicar que se conectó.
  55                         typedef SigC::Signal0<void> SignalConnected;
  56
  57                         /// Tipo de señal para indicar que se recibió una respuesta OK.
  58                         typedef SigC::Signal1<void, const std::string&> SignalOKReceived;
  59
  60                         /// Tipo de señal para indicar que se recibió un error.
  61                         typedef SigC::Signal1<void, unsigned> SignalErrorReceived;
  62
  63                         /// Tipo de señal para indicar que se recibió un frame. FIXME
  64                         typedef Receiver::SignalFrameReceived SignalFrameReceived;
  65
  66                         /**
  67                          * Obtiene la señal para indicar que se recibió una respuesta OK.
  68                          */
  69                         SignalOKReceived& signal_ok_received(void);
  70
  71                         /**
  72                          * Obtiene la señal para indicar que se recibió un error.
  73                          */
  74                         SignalErrorReceived& signal_error_received(void);
  75
  76                         /**
  77                          * Obtiene la señal que avisa cuando se recibió un cuadro.
  78                          * \todo TODO Temporal.
  79                          */
  80                         SignalFrameReceived& signal_frame_received(void);
  81
  82                 //@}
  83
  84                 /////////////////////////////////////////////////////////////////////
  85                 // Atributos.
  86
  87                 protected:
  88
  89                         /// Señal para indicar que se recibió una respuesta OK.
  90                         SignalOKReceived ok_received;
  91
  92                         /// Señal para indicar que se recibió un error.
  93                         SignalErrorReceived error_received;
  94
  95                         /// Receptor del estado de la planta TODO Temporal.
  96                         Receiver* receiver;
  97
  98                 /////////////////////////////////////////////////////////////////////
  99                 // Métodos.
 100
 101                 private:
 102
 103                         /**
 104                          * Realiza la conexión al servidor.
 105                          */
 106                         virtual void real_run(void) throw();
 107
 108                 public:
 109
 110                         /**
 111                          * Destructor.
 112                          */
 113                         virtual ~ControlClient(void);
 114
 115                         /**
 116                          * Constructor.
 117                          *
 118                          * \param _host Host al cual conectarse para enviar comandos de
 119                          *                         control.
 120                          * \param _port Puerto al cual conectarse.
 121                          */
 122                         ControlClient(const std::string& _host = "localhost",
 123                                         const Connection::Port& _port = 7522) throw(sockerr);
 124
 125                         /**
 126                          * Envía un comando al servidor.
 127                          *
 128                          * \param command Comando a enviar.
 129                          */
 130                         void send(const Command& command);
 131
 132         };
 133
 134 }
 135
 136 }
 137
 138 #endif // PLAQUI_CONTROLCLIENT_H