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                 // Constantes.
  46
  47                 protected:
  48
  49                         /// Caracteres dígitos para URIs (RFC 2396).
  50                         static const std::string CHARS_DIGIT;
  51
  52                         /// Caracteres alfabéticos en minúsculas para URIs (RFC 2396).
  53                         static const std::string CHARS_LOWALPHA;
  54
  55                         /// Caracteres alfabéticos en mayúsculas para URIs (RFC 2396).
  56                         static const std::string CHARS_UPALPHA;
  57
  58                         /// Caracteres alfabéticos para URIs (RFC 2396).
  59                         static const std::string CHARS_ALPHA;
  60
  61                         /// Caracteres alfabnuméricos para URIs (RFC 2396).
  62                         static const std::string CHARS_ALPHANUM;
  63
  64                         /// Caracteres reservados para URIs (RFC 2396).
  65                         static const std::string CHARS_RESERVED;
  66
  67                         /// Caracteres de marca para URIs (RFC 2396).
  68                         static const std::string CHARS_MARK;
  69
  70                         /// Caracteres no reservados para URIs (RFC 2396).
  71                         static const std::string CHARS_UNRESERVED;
  72
  73                         /// Caracteres no hexa para URIs (RFC 2396).
  74                         static const std::string CHARS_HEX;
  75
  76                 // Tipos.
  77
  78                 public:
  79
  80                         /// Tipo de métodos HTTP reconocidos.
  81                         typedef enum {GET, POST} HTTPMethod;
  82
  83                 // Atributos.
  84
  85                 protected: // TODO hacer privados con get() y set() ???
  86
  87                 public:
  88
  89                         /// Método HTTP.
  90                         /// @todo TODO - convertirlo a string? Hace todo más fácil (y más ineficiente :)
  91                         HTTPMethod method;
  92
  93                         /// URI.
  94                         std::string uri;
  95
  96                         /// Query string.
  97                         std::string query;
  98
  99                 // Métodos.
 100
 101                 public:
 102
 103                         /**
 104                          * Destructor.
 105                          */
 106                         virtual ~HTTPRequest(void);
 107
 108                         /**
 109                          * Constructor.
 110                          */
 111                         HTTPRequest(const std::string& uri = "/",
 112                                         const HTTPMethod& method = GET,
 113                                         const std::string& query = "",
 114                                         const std::string& body = "",
 115                                         const std::string& version = "1.1");
 116
 117                         /**
 118                          * Obtiene el método como un string.
 119                          */
 120                         std::string method_str(void) const;
 121
 122                         /**
 123                          * Obtiene los datos del pedido HTTP desde un texto.
 124                          */
 125                         friend std::istream& operator>>(std::istream& is, HTTPRequest& req)
 126                                 throw(HTTPError, sockerr, std::ios::failure);
 127
 128                         /**
 129                          * Convierte el pedido HTTP en texto.
 130                          */
 131                         friend std::ostream& operator<<(std::ostream& os,
 132                                         const HTTPRequest& req) throw(sockerr);
 133
 134         };
 135
 136 }
 137
 138 }
 139
 140 #endif // PLAQUI_HTTPREQUEST_H