jyapayne/Simple-Web-Server
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
131 commits 1 branch 0 tags 6.9 MiB
Find a file
Ole Christian Eidheim 41ff4a5988 Merge pull request #18 from bjorkegeek/master 
Use boost regex instead of std, because of buggy glibc++ in RHEL7
2015-09-29 14:16:13 +02:00
test Moved boost::asio::strand yet again. 2015-09-04 18:49:26 +02:00
web Added default GET-example 2014-07-11 12:43:58 +02:00
client_http.hpp Added custom response stream and possibility to flush response to clients synchronously and asynchronously. Various speed ups, including reduced use of regex and preprocessing of regex objects. boost::asio::ip::tcp::no_delay is now turned on for both Client and Server. Note: Not backward compatible with earlier versions. 2015-02-20 11:14:39 +01:00
client_https.hpp Added custom response stream and possibility to flush response to clients synchronously and asynchronously. Various speed ups, including reduced use of regex and preprocessing of regex objects. boost::asio::ip::tcp::no_delay is now turned on for both Client and Server. Note: Not backward compatible with earlier versions. 2015-02-20 11:14:39 +01:00
CMakeLists.txt Use boost regex instead of std, because of buggy glibc++ in RHEL7 2015-09-28 16:59:03 +02:00
http_examples.cpp Slight cleanup and added convenience function to retrieve Request::content string. 2015-09-19 13:01:40 +02:00
https_examples.cpp Update https_examples.cpp 2015-09-21 14:51:49 +02:00
LICENSE Update LICENSE 2014-07-05 20:05:52 +02:00
README.md Simpler README 2015-09-21 11:30:28 +02:00
server_http.hpp Use boost regex instead of std, because of buggy glibc++ in RHEL7 2015-09-28 16:59:03 +02:00
server_https.hpp Added custom response stream and possibility to flush response to clients synchronously and asynchronously. Various speed ups, including reduced use of regex and preprocessing of regex objects. boost::asio::ip::tcp::no_delay is now turned on for both Client and Server. Note: Not backward compatible with earlier versions. 2015-02-20 11:14:39 +01:00

README.md

Simple-Web-Server

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 also https://github.com/eidheim/Simple-WebSocket-Server for an easy way to make WebSocket/WebSocket Secure endpoints in C++.

Features

  • Thread pool
  • 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
  • Possibility to flush response to clients synchronously (Server::flush).

###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.

The default_resource includes example use of Server::flush.

Dependencies

Boost C++ libraries must be installed, go to http://www.boost.org for download and instructions.

For HTTPS: OpenSSL libraries from https://www.openssl.org are required.

Compile and run

Compile with a C++11 compiler supporting regex (for instance g++ 4.9):

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/