RequestParser.h
Go to the documentation of this file.
1 /*
2  * Copyright (C) 1996-2023 The Squid Software Foundation and contributors
3  *
4  * Squid software is distributed under GPLv2+ license and includes
5  * contributions from numerous individuals and organizations.
6  * Please see the COPYING and CONTRIBUTORS files for details.
7  */
8 
9 #ifndef SQUID_SRC_HTTP_ONE_REQUESTPARSER_H
10 #define SQUID_SRC_HTTP_ONE_REQUESTPARSER_H
11 
12 #include "http/one/Parser.h"
13 #include "http/RequestMethod.h"
14 
15 namespace Parser {
16 class Tokenizer;
17 }
18 
19 namespace Http {
20 namespace One {
21 
31 {
32 public:
33  RequestParser() = default;
34  RequestParser(bool preserveParsed) { preserveParsed_ = preserveParsed; }
35  RequestParser(const RequestParser &) = default;
36  RequestParser &operator =(const RequestParser &) = default;
37  RequestParser(RequestParser &&) = default;
38  RequestParser &operator =(RequestParser &&) = default;
39  ~RequestParser() override {}
40 
41  /* Http::One::Parser API */
42  void clear() override {*this = RequestParser();}
43  Http1::Parser::size_type firstLineSize() const override;
44  bool parse(const SBuf &aBuf) override;
45 
47  const HttpRequestMethod & method() const {return method_;}
48 
50  const SBuf &requestUri() const {return uri_;}
51 
53  const SBuf &parsed() const { Must(preserveParsed_); return parsed_; }
54 
55 private:
56  void skipGarbageLines();
59  bool doParse(const SBuf &aBuf);
60 
61  /* all these return false and set parseStatusCode on parsing failures */
63  bool parseUriField(Tokenizer &);
65  bool skipDelimiter(const size_t count, const char *where);
67 
68  bool http0() const {return !msgProtocol_.major;}
69  static const CharacterSet &RequestTargetCharacters();
70 
73 
76 
80  bool preserveParsed_ = false;
81 };
82 
83 } // namespace One
84 } // namespace Http
85 
86 #endif /* SQUID_SRC_HTTP_ONE_REQUESTPARSER_H */
87 
unsigned int major
major version number
static const CharacterSet & RequestTargetCharacters()
characters which Squid will accept in the HTTP request-target (URI)
bool skipDelimiter(const size_t count, const char *where)
const HttpRequestMethod & method() const
the HTTP method if this is a request message
Definition: RequestParser.h:47
bool parseMethodField(Tokenizer &)
Definition: SBuf.h:93
const SBuf & requestUri() const
the request-line URI if this is a request message, or an empty string.
Definition: RequestParser.h:50
bool parseUriField(Tokenizer &)
SBuf uri_
raw copy of the original client request-line URI field
Definition: RequestParser.h:75
Definition: forward.h:17
Http1::Parser::size_type firstLineSize() const override
size in bytes of the first line including CRLF terminator
SBuf::size_type size_type
Definition: Parser.h:43
const SBuf & parsed() const
the accumulated parsed bytes
Definition: RequestParser.h:53
Generic protocol-agnostic parsing tools.
Definition: RequestParser.h:15
HttpRequestMethod method_
what request method has been found on the first line
Definition: RequestParser.h:72
bool skipTrailingCrs(Tokenizer &tok)
Parse CRs at the end of request-line, just before the terminating LF.
bool doParse(const SBuf &aBuf)
called from parse() to do the parsing
RequestParser & operator=(const RequestParser &)=default
bool preserveParsed_
whether to accumulate parsed bytes (in parsed_)
Definition: RequestParser.h:80
bool parse(const SBuf &aBuf) override
RequestParser(bool preserveParsed)
Definition: RequestParser.h:34
Definition: parse.c:160
::Parser::Tokenizer Tokenizer
Definition: Parser.h:44
AnyP::ProtocolVersion msgProtocol_
what protocol label has been found in the first line (if any)
Definition: Parser.h:152
#define Must(condition)
Definition: TextException.h:75
optimized set of C chars, with quick membership test and merge support
Definition: CharacterSet.h:17
bool parseHttpVersionField(Tokenizer &)
void clear() override
Definition: RequestParser.h:42

 

Introduction

Documentation

Support

Miscellaneous