include/anna/comm/Application.hpp

   1 // ANNA - Anna is Not Nothingness Anymore                                                         //
   2 //                                                                                                //
   3 // (c) Copyright 2005-2015 Eduardo Ramos Testillano & Francisco Ruiz Rayo                         //
   4 //                                                                                                //
   5 // See project site at http://redmine.teslayout.com/projects/anna-suite                           //
   6 // See accompanying file LICENSE or copy at http://www.teslayout.com/projects/public/anna.LICENSE //
   7
   8
   9 #ifndef anna_comm_Application_hpp
  10 #define anna_comm_Application_hpp
  11
  12 #include <vector>
  13
  14 #include <anna/app/Application.hpp>
  15
  16 #include <anna/comm/functions.hpp>
  17
  18 namespace anna {
  19
  20 namespace xml {
  21 class Node;
  22 }
  23
  24 namespace comm {
  25
  26 class Communicator;
  27 class TransportFactory;
  28
  29 /**
  30    Clase que modela el cargador de configuracin de gestor de comunicaciones.
  31
  32    Esta clase realiza dos operaciones primordiales para el comunicador:
  33    \li Establece las direcciones en las que el comunicador de nuestra aplicacion atiende peticiones
  34    de los procesos clientes. Este paso slo sera necesario si nuestro proceso acta como servidor
  35    de algn otro proceso.
  36    \li Establece las direcciones de los servidores de nuestra aplicacion. Este paso slo sera necesario
  37    si nuestra aplicacion acta como cliente de algn otro servidor.
  38
  39    Hay que destacar que nuestra aplicacion puede actuar simultaneamente como cliente y/o servidor por
  40    lo que puede haber ocasiones en que sea requieran las dos operaciones.
  41
  42    \see Communicator::setup
  43 */
  44 class Application : public app::Application {
  45 public:
  46   /**
  47      Devuelve la instancia de la factoria de protocolos a usar por defecto en esta
  48      aplicacion.
  49      \return La instancia de la factoria de protocolos a usar por defecto en esta
  50      aplicacion.
  51   */
  52   virtual TransportFactory& getDefaultTransportFactory() throw();
  53
  54 protected:
  55   /**
  56      Constructor.
  57
  58      @param shortName Nombre lgico de esta instancia. Ver Runnable.
  59      @param title titulo de la aplicacion que aparecera al arrancar.
  60      @param version Version de este programa. Aconsejamos el forma X.YRZZ. Donde X es la
  61      version principal, Y la version secundaria y ZZ es el nmero de entrega realizada.
  62      \param date Fecha de realizacion del componente. Normalmente sera el contenido de la macro __DATE__.
  63      \param time Hora de realizacion del componente. Normalmente sera el contenido de la macro __TIME__.
  64   */
  65   Application(const char *shortName, const char *title, const char *version, const char* date = NULL, const char* time = NULL);
  66
  67   /**
  68      Metodo manejador que podemos re-escribir para tratar la recepcion de la senhal SIGTERM.
  69   */
  70   virtual void signalTerminate() throw(RuntimeException);
  71
  72 private:
  73   Application(const Application&);
  74   bool supportCommunication() const throw() { return true; }
  75
  76   friend class Communicator;
  77   friend anna::comm::Application& comm::functions::getApp() throw(RuntimeException);
  78 };
  79
  80 }
  81 }
  82
  83 #endif