net/test/embedded_test_server/http_request.h

   1 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #ifndef NET_TEST_EMBEDDED_TEST_SERVER_HTTP_REQUEST_H_
   6 #define NET_TEST_EMBEDDED_TEST_SERVER_HTTP_REQUEST_H_
   7
   8 #include <map>
   9 #include <string>
  10
  11 #include "base/basictypes.h"
  12 #include "base/memory/scoped_ptr.h"
  13 #include "base/strings/string_piece.h"
  14
  15 namespace net {
  16 namespace test_server {
  17
  18 // Methods of HTTP requests supported by the test HTTP server.
  19 enum HttpMethod {
  20   METHOD_UNKNOWN,
  21   METHOD_GET,
  22   METHOD_HEAD,
  23   METHOD_POST,
  24   METHOD_PUT,
  25   METHOD_DELETE,
  26   METHOD_PATCH,
  27 };
  28
  29 // Represents a HTTP request. Since it can be big, use scoped_ptr to pass it
  30 // instead of copying. However, the struct is copyable so tests can save and
  31 // examine a HTTP request.
  32 struct HttpRequest {
  33   HttpRequest();
  34   ~HttpRequest();
  35
  36   std::string relative_url;  // Starts with '/'. Example: "/test?query=foo"
  37   HttpMethod method;
  38   std::string method_string;
  39   std::map<std::string, std::string> headers;
  40   std::string content;
  41   bool has_content;
  42 };
  43
  44 // Parses the input data and produces a valid HttpRequest object. If there is
  45 // more than one request in one chunk, then only the first one will be parsed.
  46 // The common use is as below:
  47 // HttpRequestParser parser;
  48 // (...)
  49 // void OnDataChunkReceived(Socket* socket, const char* data, int size) {
  50 //   parser.ProcessChunk(std::string(data, size));
  51 //   if (parser.ParseRequest() == HttpRequestParser::ACCEPTED) {
  52 //     scoped_ptr<HttpRequest> request = parser.GetRequest();
  53 //     (... process the request ...)
  54 //   }
  55 class HttpRequestParser {
  56  public:
  57   // Parsing result.
  58   enum ParseResult {
  59     WAITING,  // A request is not completed yet, waiting for more data.
  60     ACCEPTED,  // A request has been parsed and it is ready to be processed.
  61   };
  62
  63   // Parser state.
  64   enum State {
  65     STATE_HEADERS,  // Waiting for a request headers.
  66     STATE_CONTENT,  // Waiting for content data.
  67     STATE_ACCEPTED,  // Request has been parsed.
  68   };
  69
  70   HttpRequestParser();
  71   ~HttpRequestParser();
  72
  73   // Adds chunk of data into the internal buffer.
  74   void ProcessChunk(const base::StringPiece& data);
  75
  76   // Parses the http request (including data - if provided).
  77   // If returns ACCEPTED, then it means that the whole request has been found
  78   // in the internal buffer (and parsed). After calling GetRequest(), it will be
  79   // ready to parse another request.
  80   ParseResult ParseRequest();
  81
  82   // Retrieves parsed request. Can be only called, when the parser is in
  83   // STATE_ACCEPTED state. After calling it, the parser is ready to parse
  84   // another request.
  85   scoped_ptr<HttpRequest> GetRequest();
  86
  87  private:
  88   HttpMethod GetMethodType(const std::string& token) const;
  89
  90   // Parses headers and returns ACCEPTED if whole request was parsed. Otherwise
  91   // returns WAITING.
  92   ParseResult ParseHeaders();
  93
  94   // Parses request's content data and returns ACCEPTED if all of it have been
  95   // processed. Chunked Transfer Encoding *is not* supported.
  96   ParseResult ParseContent();
  97
  98   // Fetches the next line from the buffer. Result does not contain \r\n.
  99   // Returns an empty string for an empty line. It will assert if there is
 100   // no line available.
 101   std::string ShiftLine();
 102
 103   scoped_ptr<HttpRequest> http_request_;
 104   std::string buffer_;
 105   size_t buffer_position_;  // Current position in the internal buffer.
 106   State state_;
 107   // Content length of the request currently being parsed.
 108   size_t declared_content_length_;
 109
 110   DISALLOW_COPY_AND_ASSIGN(HttpRequestParser);
 111 };
 112
 113 }  // namespace test_server
 114 }  // namespace net
 115
 116 #endif  // NET_TEST_EMBEDDED_TEST_SERVER_HTTP_REQUEST_H_