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