Name | Modified | Size | Downloads / Week |
---|---|---|---|
simplewebservercpp-1.4.tar.gz | 2015-09-08 | 10.8 kB | |
README.md | 2015-09-08 | 2.7 kB | |
simplewebservercpp-1.3.3.tar.gz | 2015-01-30 | 8.9 kB | |
simplewebservercpp-1.3.2.tar.gz | 2014-11-02 | 8.0 kB | |
simplewebservercpp-1.3.1.tar.gz | 2014-11-01 | 8.0 kB | |
simplewebservercpp-1.3.tar.gz | 2014-08-14 | 8.0 kB | |
simplewebservercpp-1.2.tar.gz | 2014-08-02 | 5.8 kB | |
simplewebservercpp-1.1.tar.gz | 2014-07-13 | 5.7 kB | |
Totals: 8 Items | 58.0 kB | 1 |
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):
On Linux using g++: add -pthread
Note: added -lboost_filesystem
for the default_resource example, and -lboost_thread
to make the json-example thread safe. Also added -lboost_coroutine -lboost_context
to make synchronous flushing of response stream work. On some systems you might have to use postfix -mt
to link to these libraries.
You can now also compile using CMake and make:
cmake .
make
HTTP
g++ -O3 -std=c++11 http_examples.cpp -lboost_system -lboost_thread -lboost_coroutine -lboost_context -lboost_filesystem -o http_examples
Then to run the server and client examples: ./http_examples
Also, direct your favorite browser to for instance http://localhost:8080/
HTTPS
g++ -O3 -std=c++11 https_examples.cpp -lboost_system -lboost_thread -lboost_coroutine -lboost_context -lboost_filesystem -lssl -lcrypto -o https_examples
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
Then to run the server and client examples: ./https_examples
Also, direct your favorite browser to for instance https://localhost:8080/