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