Server/include/plaqui/server/httprequest.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:  dom oct 26 18:54:30 ART 2003
  22 // Autores: Leandro Lucarella <llucare@fi.uba.ar>
  23 //----------------------------------------------------------------------------
  24 //
  25 // $Id$
  26 //
  27
  28 #ifndef PLAQUI_HTTPREQUEST_H
  29 #define PLAQUI_HTTPREQUEST_H
  30
  31 #include "plaqui/server/httperror.h"
  32 #include "plaqui/server/httpmessage.h"
  33 #include <socket++/sockstream.h>
  34 #include <string>
  35 #include <istream>
  36 #include <ostream>
  37
  38 namespace PlaQui {
  39
  40 namespace Server {
  41
  42         /// Pedido HTTP.
  43         class HTTPRequest: public HTTPMessage {
  44
  45                 /////////////////////////////////////////////////////////////////////
  46                 // Constantes.
  47
  48                 protected:
  49
  50                         /// Caracteres dígitos para URIs (RFC 2396).
  51                         static const std::string CHARS_DIGIT;
  52
  53                         /// Caracteres alfabéticos en minúsculas para URIs (RFC 2396).
  54                         static const std::string CHARS_LOWALPHA;
  55
  56                         /// Caracteres alfabéticos en mayúsculas para URIs (RFC 2396).
  57                         static const std::string CHARS_UPALPHA;
  58
  59                         /// Caracteres alfabéticos para URIs (RFC 2396).
  60                         static const std::string CHARS_ALPHA;
  61
  62                         /// Caracteres alfabnuméricos para URIs (RFC 2396).
  63                         static const std::string CHARS_ALPHANUM;
  64
  65                         /// Caracteres reservados para URIs (RFC 2396).
  66                         static const std::string CHARS_RESERVED;
  67
  68                         /// Caracteres de marca para URIs (RFC 2396).
  69                         static const std::string CHARS_MARK;
  70
  71                         /// Caracteres no reservados para URIs (RFC 2396).
  72                         static const std::string CHARS_UNRESERVED;
  73
  74                         /// Caracteres no hexa para URIs (RFC 2396).
  75                         static const std::string CHARS_HEX;
  76
  77                 /////////////////////////////////////////////////////////////////////
  78                 // Tipos.
  79
  80                 public:
  81
  82                         /// Tipo de métodos HTTP reconocidos.
  83                         typedef enum {GET, POST} HTTPMethod;
  84
  85                 /////////////////////////////////////////////////////////////////////
  86                 // Atributos.
  87
  88                 protected: // TODO hacer privados con get() y set() ???
  89
  90                 public:
  91
  92                         /// Método HTTP.
  93                         /// @todo TODO - convertirlo a string? Hace todo más fácil (y más ineficiente :)
  94                         HTTPMethod method;
  95
  96                         /// URI.
  97                         std::string uri;
  98
  99                         /// Query string.
 100                         std::string query;
 101
 102                 /////////////////////////////////////////////////////////////////////
 103                 // Métodos.
 104
 105                 public:
 106
 107                         /**
 108                          * Destructor.
 109                          */
 110                         virtual ~HTTPRequest(void);
 111
 112                         /**
 113                          * Constructor.
 114                          */
 115                         HTTPRequest(const std::string& uri = "/",
 116                                         const HTTPMethod& method = GET,
 117                                         const std::string& query = "",
 118                                         const std::string& body = "",
 119                                         const std::string& version = "1.1");
 120
 121                         /**
 122                          * Obtiene el método como un string.
 123                          */
 124                         std::string method_str(void) const;
 125
 126                         /**
 127                          * Obtiene los datos del pedido HTTP desde un texto.
 128                          */
 129                         friend std::istream& operator>>(std::istream& is, HTTPRequest& req)
 130                                 throw(HTTPError, sockerr, std::ios::failure);
 131
 132                         /**
 133                          * Convierte el pedido HTTP en texto.
 134                          */
 135                         friend std::ostream& operator<<(std::ostream& os,
 136                                         const HTTPRequest& req) throw(sockerr);
 137
 138         };
 139
 140 }
 141
 142 }
 143
 144 #endif // PLAQUI_HTTPREQUEST_H