HTTP client capabilities.

[ben-crowhurst]

struct Http::Request
{
      Bytes body;
      uint16_t port;
      string method;
      struct SSL { ... }
      ...
      std::future< Http::Response > response;
};

Http::sync( Http::Request request );
Http::sync( std::list< Http::Request >& requests );

Http::async( Http::Request request );
Http::async( std::list< Http::Request >& requests );

The async methods fire off as many requests as possible and return without blocking. It is then the responsibility of the developer to check each future for a ready response.

for ( auto request : requests )
{
    if ( request.response.wait_for( std::chrono::seconds( 0 ) ) == std::future_status::ready )
    {
        //process response.
    }
}

Further discussion is required around sharing the same asio::io_service as the restbed::Service or having a separate instance.

[ben-crowhurst]

A customer has stated:

In our case, calling off the same asio::io_service probably wouldn't be an issue initially, however I could imagine cases where you might want to not do that.

[ben-crowhurst]

struct Http::Request
{
      bool async;
      ...
      std::future< Http::Response > response;
};

Placing HTTP requests on the service run-loop.

service.schedule( Http::Request request, const function< void ( Http::Request ) >& callback );
service.schedule( list< Http::Request > request,  const function< void ( Http::Request ) >& callback );

Placing HTTP requests on its own run-loop

Http::sync( Http::Request request );
Http::sync( std::list< Http::Request >& requests );

Http::async( Http::Request request );
Http::async( std::list< Http::Request >& requests );

[ben-crowhurst]

Placing HTTP requests on the service run-loop

service.schedule( Http::Request request, const function< void ( Http::Request ) >& callback );
service.schedule( list< Http::Request > request,  const function< void ( Http::Request ) >& callback );

Placing HTTP requests on its own run-loop

Http::sync( Http::Request request );
Http::sync( std::list< Http::Request >& requests );

Http::async( Http::Request request );
Http::async( std::list< Http::Request >& requests );

Perform SSL requests

SSLSetting settings;

Request request;
request.set_protocol( "HTTPS", settings );

Http::sync( request );