https://github.com/eidheim/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.
https://github.com/eidheim/simple-web-server
asio client cpp http https library rest server web
Last synced: 4 months ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/eidheim/simple-web-server
- Owner: eidheim
- License: mit
- Archived: true
- Created: 2014-07-05T09:47:12.000Z (almost 11 years ago)
- Default Branch: master
- Last Pushed: 2018-06-12T09:22:10.000Z (almost 7 years ago)
- Last Synced: 2024-09-25T22:01:00.994Z (8 months ago)
- Topics: asio, client, cpp, http, https, library, rest, server, web
- Language: C++
- Homepage:
- Size: 6.42 MB
- Stars: 2,610
- Watchers: 172
- Forks: 751
- Open Issues: 54
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
**_This project has moved to https://gitlab.com/eidheim/Simple-Web-Server._**
Simple-Web-Server
=================
A very simple, fast, multithreaded, platform independent HTTP and HTTPS server and client library implemented using C++11 and Asio (both Boost.Asio and standalone Asio can be used). Created to be an easy way to make REST resources available from C++ applications.
See https://gitlab.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://gitlab.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.Asio or standalone Asio
* Boost is required to compile the examples
* For HTTPS: OpenSSL libraries
### Compile and run
Compile with a C++11 compliant compiler:
```sh
mkdir build
cd build
cmake ..
make
cd ..
```
#### HTTP
Run the server and client examples: `./build/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: `./build/https_examples`
Direct your favorite browser to for instance https://localhost:8080/