jyapayne/Simple-Web-Server
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
202 commits 1 branch 0 tags 6.9 MiB
Find a file
eidheim 7120e8aff2 Minor typo fix
2016-09-07 20:56:23 +02:00
tests Renamed test folder to tests 2016-08-03 12:15:32 +02:00
web Added default GET-example 2014-07-11 12:43:58 +02:00
.gitignore Added io_test 2016-08-03 11:32:11 +02:00
.travis.yml Added CI 2016-08-03 11:57:40 +02:00
client_http.hpp Changed private to protected in Server/Client<HTTP/HTTPS> classes, and some cleanup 2016-08-21 10:59:24 +02:00
client_https.hpp Fixes #66, added boost::asio::ssl::context::set_default_verify_paths when verify_certificate is set to true in Client<HTTPS> constructor 2016-08-24 09:26:38 +02:00
CMakeLists.txt Fixes #62, required boost version is now 1.53 2016-08-18 12:36:17 +02:00
http_examples.cpp Minor typo fix 2016-09-07 20:56:23 +02:00
https_examples.cpp Minor typo fix 2016-09-07 20:56:23 +02:00
LICENSE Updated copyright year in LICENSE 2016-07-01 09:26:44 +02:00
README.md Added CI 2016-08-03 11:57:40 +02:00
server_http.hpp Minor cleanup of exception_handler code 2016-09-07 09:01:01 +02:00
server_https.hpp only use tlsv12, nothing older 2016-08-21 07:42:58 -04:00

README.md

Simple-Web-Server Build Status

A very simple, fast, multithreaded, platform independent HTTP and HTTPS server and client library implemented using C++11 and Boost.Asio. Created to be an easy way to make REST resources available from C++ applications.

See https://github.com/eidheim/Simple-WebSocket-Server for an easy way to make WebSocket/WebSocket Secure endpoints in C++. Also, feel free to check out the new C++ IDE supporting C++11/14/17: https://github.com/cppit/jucipp.

Features

  • Asynchronous request handling
  • Thread pool if needed
  • Platform independent
  • HTTPS support
  • HTTP persistent connection (for HTTP/1.1)
  • Client supports chunked transfer encoding
  • Timeouts, if any of Server::timeout_request and Server::timeout_content are >0 (default: Server::timeout_request=5 seconds, and Server::timeout_content=300 seconds)
  • Simple way to add REST resources using regex for path, and anonymous functions

###Usage

See http_examples.cpp or https_examples.cpp for example usage.

See particularly the JSON-POST (using Boost.PropertyTree) and the GET /match/[number] examples, which are most relevant.

Dependencies

  • Boost C++ libraries
  • For HTTPS: OpenSSL libraries

Compile and run

Compile with a C++11 compliant compiler:

cmake .
make

HTTP

Run the server and client examples: ./http_examples

Direct your favorite browser to for instance http://localhost:8080/

HTTPS

Before running the server, an RSA private key (server.key) and an SSL certificate (server.crt) must be created. Follow, for instance, the instructions given here (for a self-signed certificate): http://www.akadia.com/services/ssh_test_certificate.html

Run the server and client examples: ./https_examples

Direct your favorite browser to for instance https://localhost:8080/