Protocol-HTTP

Protocol-HTTP - very fast HTTP protocol incremental parser and serializer

Features: cookies, transparent (un)compression with Gzip or Brotli, transparent chunked transfer encoding for body streaming, respecting request's preferences when making response.

The module is a protocol implementation, by itself it does not perform any I/O activity. For HTTP library see UniEvent-HTTP.

Currenly supported HTTP versions are 1.0 and 1.1

Synopsis

using namespace panda::protocol::http;
RequestSP request = Request::Builder()
    .method(Method::Get)
    .uri("http://crazypanda.ru/hello/world")
    .header("MyHeader", "my value")
    .header("MyAtherH", "val2")
    .cookie("coo1", "val2")
    .body("my body")
    .build();

string req_str = request->to_string(); // => GET /hello/world HTTP/1.1| ...

// server api - parse request
// my ($state, $position, $error);
RequestParser req_parser;
auto result = req_parser.parse(req_str);
if (result.state == State::done) {
    RequestSP request = result.request;
    std::cout << request->uri << "\n"
                << request->body;

    string next_req = req_str.substr(result.position);
}

// server api - make response
ResponseSP response = Response::Builder()
    .code(200)
    .header("Lang", "C++")
    .body("Lorem ipsum dolor")
    .build();

string res_str = response->to_string(request);

// client api - parse response
ResponseParser res_parser;
res_parser.set_context_request(request);
auto response_result = res_parser.parse(res_str);
if (response_result.state == State::done) {
    ResponseSP response = response_result.response;
    std::cout << response->code    // 200, 404, etc
                << response->message // status message, e.g OK
                << response->body;
}
// compression with chunks

request = Request::Builder()
    .method(Method::Post)
    .uri("https://images.example.com/upload")
    .compress(compression::Compression::GZIP)
    .chunked()
    .build();

std::cout << request->to_string(); // only http headers
auto chunk = request->make_chunk("hello-world"); // outputs first chunk
for (const string& s : chunk) {
    std::cout << s;
}
chunk = request->final_chunk(); // outputs final chunk
for (const string& s : chunk) {
    std::cout << s;
}

// cookies jar (for user-agents aka HTTP-clients)
CookieJar jar;
jar.populate(*request); // before request sent
jar.collect(*response, request->uri); // after response is received

Build and Install

Protocol-HTTP can be wuild using CMake. It supports both find_package and add_subdirectory approaches. Target name to link against your library or executable is panda-protocol-http.

Dependencies:

• panda-lib
• Date
• Panda-URI
• range-v3
• Boost container (small_vector, it is header only)
• zlib

Reference

In progress