HTTP

http is a basic web server written in C++ using the linux sockets API.

Usage

Functions for endpoints can be declared using http::Request& and http::Response& as argument types, with return value void.

It can then be handled using the handle function, which requires a string route (can be a regular expression) and the respective function declared.

Note All classes and functions are under the namespace http.

HTTP Server

#include "../include/server.hpp"

void root(http::Request &req, http::Response &res) {
    http::Method method = req.method();
    switch (method) {
    case http::Method::GET:
        res.set_status(http::Status::OK);
        res.set_content_type(http::MIME::TXT);
        res.set_body("Hello World!");
        return;
    default:
        res.set_status(http::Status::METHOD_NOT_ALLOWED);
        return;
    }
}

int main() {
    http::Server server(8080);
    server.handle("/", root);
    // Handle a route using lambda function, the endpoint can be a
    // regular expression.
    server.handle(R"(^(\/)(.*)$)", [](http::Request &req, http::Response &res) {
        res.set_status(http::Status::NOT_FOUND);
    })
    server.listen_and_serve();
    return 0;
}

HTTPS Server (TLS)

#include "../include/sslserver.hpp"

void root(http::Request &req, http::Response &res) {
    http::Method method = req.method();
    switch (method) {
    case http::Method::GET:
        res.set_status(http::Status::OK);
        res.set_content_type(http::MIME::TXT);
        res.set_body("Hello World!");
        return;
    default:
        res.set_status(http::Status::METHOD_NOT_ALLOWED);
        return;
    }
}

int main() {
    http::TLSServer server(8080, "<ssl_certificate_path>", "<ssl_private_key_path>");
    server.handle("/", root);
    server.handle(R"(^(\/)(.*)$)", [](http::Request &req, http::Response &res) {
        res.set_status(http::Status::NOT_FOUND);
    })
    server.listen_and_serve();
    return 0;
}

Running Dockerfile

To run a sample server, a docker image can be created and run.

docker build . -t <tag>
docker run -p 8080:8080 <tag>

To Do

• Create Enum class for common MIME types
• Add cookie methods to Message class
• Parse cookie in Request constructor
• Overload << operator for Request and Response
• Dockerize a sample server
• Create a JSON parser

References:

• https://github.com/trungams/http-server
• https://bruinsslot.jp/post/simple-http-webserver-in-c/