Http

This is a library which implements RFC 7230, "Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing".

Usage

The Http::Server class is used to parse incoming HTTP requests (from web browsersor automated programs), route them to handlers that can satisfy the requests, and then generate appropriate HTTP responses to return back to the original HTTP request senders.

The Http::Client class is used to generate HTTP requests (for web servers) and parse HTTP responses received back from web servers.

Supported platforms / recommended toolchains

This is a portable C++11 library which depends only on the C++11 compiler and standard library, so it should be supported on almost any platform. The following are recommended toolchains for popular platforms.

Windows -- Visual Studio (Microsoft Visual C++)
Linux -- clang or gcc
MacOS -- Xcode (clang)

Building

This library is not intended to stand alone. It is intended to be included in a larger solution which uses CMake to generate the build system and build applications which will link with the library.

There are two distinct steps in the build process:

Generation of the build system, using CMake
Compiling, linking, etc., using CMake-compatible toolchain

Prerequisites

CMake version 3.8 or newer
C++11 toolchain compatible with CMake for your development platform (e.g. Visual Studio on Windows)

Build system generation

Generate the build system using CMake from the solution root. For example:

mkdir build
cd build
cmake -G "Visual Studio 15 2017" -A "x64" ..

Compiling, linking, et cetera

Either use CMake or your toolchain's IDE to build. For CMake:

cd build
cmake --build . --config Release