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.
5 #ifndef NET_TEST_EMBEDDED_TEST_SERVER_HTTP_REQUEST_H_
6 #define NET_TEST_EMBEDDED_TEST_SERVER_HTTP_REQUEST_H_
11 #include "base/basictypes.h"
12 #include "base/memory/scoped_ptr.h"
13 #include "base/strings/string_piece.h"
16 namespace test_server {
18 // Methods of HTTP requests supported by the test HTTP server.
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.
36 std::string relative_url; // Starts with '/'. Example: "/test?query=foo"
38 std::string method_string;
39 std::map<std::string, std::string> headers;
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;
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 ...)
55 class HttpRequestParser {
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.
65 STATE_HEADERS, // Waiting for a request headers.
66 STATE_CONTENT, // Waiting for content data.
67 STATE_ACCEPTED, // Request has been parsed.
73 // Adds chunk of data into the internal buffer.
74 void ProcessChunk(const base::StringPiece& data);
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();
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
85 scoped_ptr<HttpRequest> GetRequest();
88 HttpMethod GetMethodType(const std::string& token) const;
90 // Parses headers and returns ACCEPTED if whole request was parsed. Otherwise
92 ParseResult ParseHeaders();
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();
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();
103 scoped_ptr<HttpRequest> http_request_;
105 size_t buffer_position_; // Current position in the internal buffer.
107 // Content length of the request currently being parsed.
108 size_t declared_content_length_;
110 DISALLOW_COPY_AND_ASSIGN(HttpRequestParser);
113 } // namespace test_server
116 #endif // NET_TEST_EMBEDDED_TEST_SERVER_HTTP_REQUEST_H_