GitHub - Corvusoft/restbed: Corvusoft's Restbed framework brings asynchronous RESTful functionality to C++14 applications. (original) (raw)

Restbed

Restbed is a robust, enterprise-class framework for building server-side applications that demand secure, reliable, and scalable HTTP communication. It provides a flexible foundation for modeling complex business processes and is engineered to support deployment across mobile, tablet, desktop, and embedded environments.

It's akin to embedding NGINX into your companies own product line. -- Solutions Architect, Bellrock Technology

Features

Example

#include #include #include

using namespace std; using namespace restbed;

void post_method_handler( const shared_ptr< Session > session ) { const auto request = session->get_request( );

int content_length = request->get_header( "Content-Length", 0 );

session->fetch( content_length, [ ]( const shared_ptr< Session > session, const Bytes & body )
{
    fprintf( stdout, "%.*s\n", ( int ) body.size( ), body.data( ) );
    session->close( OK, "Hello, World!", { { "Content-Length", "13" } } );
} );

}

int main( const int, const char** ) { auto resource = make_shared< Resource >( ); resource->set_path( "/resource" ); resource->set_method_handler( "POST", post_method_handler );

auto settings = make_shared< Settings >( );
settings->set_port( 1984 );
settings->set_default_header( "Connection", "close" );

Service service;
service.publish( resource );
service.start( settings );

return EXIT_SUCCESS;

}

More in-depth examples can be found in the documentation.

License

© 2013-2025 Corvusoft Limited, United Kingdom. All rights reserved.

The Restbed framework is dual licensed; See LICENSE for full details.

Support

Please contact sales@corvusoft.com, for support and licensing options including bespoke software development, testing, design consultation, training, mentoring and code review.

Please submit all enhancements, proposals, and defects via the issue tracker; Alternatively ask a question on StackOverflow tagged #restbed.

Prerequisites

Catch2 is a modern, C++-native, test framework for unit-tests, TDD, BDD, and benchmarks.

git clone https://github.com/catchorg/Catch2.git --branch v3.8.1 --single-branch
cd Catch2
mkdir build
cd build
cmake ..
make install

Asio is a cross-platform C++ library for network and low-level I/O programming that provides developers with a consistent asynchronous model using a modern C++ approach.

git clone https://github.com/chriskohlhoff/asio --branch asio-1-34-2 --single-branch
cd asio/asio
./autogen.sh
./configure
make install

OpenSSL is a robust, commercial-grade, full-featured Open Source Toolkit for the TLS (formerly SSL), DTLS and QUIC protocols.

git clone https://github.com/openssl/openssl.git --branch openssl-3.5.0 --single-branch
cd openssl
./config
make install

Build

git clone https://github.com/corvusoft/restbed.git --branch 4.8 --single-branch cd restbed mkdir restbed/build cd restbed/build cmake [-DBUILD_SSL=NO] [-DBUILD_TESTS=NO] .. make install make test

You will now find all required components installed in the distribution sub-folder.

Build Options

Windows Build Instructions

Prerequisites: Visual Studio 2022, CMake, GIT, Perl.

Using the x64 Native Tools Command Prompt begin by, if required, building OpenSSL.

git clone --recursive https://github.com/openssl/openssl.git

cd openssl perl Configure [no-]shared nmake nmake test

If you selected to use the default OpenSSL build (shared), you'll need to include the installation path in your environment.

If you selected to use the static OpenSSL build (no-shared), you'll need to include additional dependencies when linking your application code; See OpenSSL project for futher details.

target_link_libraries( my_microservice restbed-static.lib ws2_32.lib advapi32.lib crypt32.lib gdi32.lib user32.lib )

Now proceed with the following Restbed build instructions.

git clone --recursive https://github.com/corvusoft/restbed.git

mkdir restbed\build cd restbed\build cmake -G "Visual Studio 17 2022" [-DBUILD_SSL=NO] [-DBUILD_TESTS=NO] .. cmake --build . --target ALL_BUILD --config Release ctest

For Microsoft Visual Studio 14 2015 instructions, and further details, please see feature #17.

Documentation

This codebase is intended to be as self documenting as possible. We have supplied many examples and test suites to help aid developers.

You can locate the latest design and API documentation here.

Minimum Requirements

Contact