include/anna/comm/DirectTransport.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_DirectTransport_hpp
  10 #define anna_comm_DirectTransport_hpp
  11
  12 #include <anna/core/DataBlock.hpp>
  13
  14 #include <anna/comm/Transport.hpp>
  15 #include <anna/comm/TransportFactory.hpp>
  16 #include <anna/comm/TransportFactoryImpl.hpp>
  17
  18 namespace anna {
  19
  20 namespace comm {
  21
  22 /**
  23    Clase generica para definir la capa de transporte del protocolo de comunicaciones sin ningun tipo
  24    de aditivos, envia el bloque de datos tal y como le llega.
  25
  26    Este protocolo esta orientado a intercambiar mensajes en una red interna, por lo que supone
  27    que no van a existir errores en los mensajes recibidos y que los mensajes son suficientemente cortos
  28    como poder representar su longitud en dos unicos bytes.
  29
  30    Los supuestos bajo los que se puede este protocolo facilitan el desarrollo de clases que ofrecen un
  31    gran rendimiento, pero imposibilitan el desarrollo del sistema de re-sincronizacin en caso de que alguno
  32    de los mensajes no cumpla los supuestos. Es decir, si nos llega un mensaje erroneo nuestro proceso no sera
  33    capaz de volver a sincronizarse nunca mas y terminara cerrando el ClientSocket.
  34
  35    \warning Hay que tener en cuenta que el metodo de codificacion no ofrece informacin
  36    suficiente para poder re-sincronizar los procesos en caso de error.
  37
  38    \see Transport.
  39 */
  40 class DirectTransport : public comm::Transport {
  41 public:
  42   /**
  43      Destructor
  44   */
  45   ~DirectTransport();
  46
  47   /**
  48      Devuelve el gestor de capas de transporte asociado a esta clase.
  49      \return El gestor de capas de transporte asociado a esta clase.
  50   */
  51   static TransportFactory& getFactory() throw() { return st_transportFactory; }
  52
  53   /**
  54       Devuelve el literal que indentifica de esta clase.
  55       \return el literal que indentifica de esta clase.
  56    */
  57   static const char* className() throw() { return "anna::comm::DirectTransport"; }
  58
  59 private:
  60   static TransportFactoryImpl <DirectTransport> st_transportFactory;
  61
  62   DirectTransport();
  63
  64   int calculeSize(const DataBlock& dataBlock) throw(RuntimeException) { return dataBlock.getSize(); }
  65   const Message* decode(const DataBlock&) throw(RuntimeException);
  66   const DataBlock& code(Message&) throw(RuntimeException);
  67
  68   friend class anna::Allocator <DirectTransport>;
  69 };
  70
  71 }
  72 }
  73 #endif
  74