Refactor all examples:

fix #575, fix #604, fix #608, fix #634, fix #712

All examples are rewritten:

* Using Best Practices
* Mostly self-contained
* New examples to complete the feature matrix
* The server-framework example is removed

example/websocket/client/coro-ssl/CMakeLists.txt

@@ -0,0 +1,23 @@
+#
+# Copyright (c) 2016-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+#
+# Distributed under the Boost Software License, Version 1.0. (See accompanying
+# file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+#
+# Official repository: https://github.com/boostorg/beast
+#
+
+GroupSources(include/boost/beast beast)
+GroupSources(example/common common)
+GroupSources(example/websocket/client/coro-ssl "/")
+
+add_executable (websocket-client-coro-ssl
+    ${BOOST_BEAST_INCLUDES}
+    ${PROJECT_SOURCE_DIR}/example/common/root_certificates.hpp
+    Jamfile
+    websocket_client_coro_ssl.cpp
+)
+
+target_link_libraries (websocket-client-coro-ssl
+    ${OPENSSL_LIBRARIES}
+    )

example/websocket/client/coro-ssl/Jamfile

@@ -0,0 +1,21 @@
+#
+# Copyright (c) 2016-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+#
+# Distributed under the Boost Software License, Version 1.0. (See accompanying
+# file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+#
+# Official repository: https://github.com/boostorg/beast
+#
+
+project
+    : requirements
+    <library>ssl
+    <library>crypto
+    ;
+
+exe websocket-client-coro-ssl :
+    websocket_client_coro_ssl.cpp
+    :
+    <variant>coverage:<build>no
+    <variant>ubasan:<build>no
+    ;

example/websocket/client/coro-ssl/websocket_client_coro_ssl.cpp

@@ -0,0 +1,144 @@
+//
+// Copyright (c) 2016-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
+//
+// Distributed under the Boost Software License, Version 1.0. (See accompanying
+// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+//
+// Official repository: https://github.com/boostorg/beast
+//
+
+//------------------------------------------------------------------------------
+//
+// Example: WebSocket SSL client, coroutine
+//
+//------------------------------------------------------------------------------
+
+#include "example/common/root_certificates.hpp"
+
+#include <boost/beast/core.hpp>
+#include <boost/beast/websocket.hpp>
+#include <boost/beast/websocket/ssl.hpp>
+#include <boost/asio/connect.hpp>
+#include <boost/asio/spawn.hpp>
+#include <boost/asio/ip/tcp.hpp>
+#include <boost/asio/ssl/stream.hpp>
+#include <cstdlib>
+#include <functional>
+#include <iostream>
+#include <string>
+
+using tcp = boost::asio::ip::tcp;               // from <boost/asio/ip/tcp.hpp>
+namespace ssl = boost::asio::ssl;               // from <boost/asio/ssl.hpp>
+namespace websocket = boost::beast::websocket;  // from <boost/beast/websocket.hpp>
+
+//------------------------------------------------------------------------------
+
+// Report a failure
+void
+fail(boost::system::error_code ec, char const* what)
+{
+    std::cerr << what << ": " << ec.message() << "\n";
+}
+
+// Sends a WebSocket message and prints the response
+void
+do_session(
+    std::string const& host,
+    std::string const& port,
+    std::string const& text,
+    boost::asio::io_service& ios,
+    ssl::context& ctx,
+    boost::asio::yield_context yield)
+{
+    boost::system::error_code ec;
+
+    // These objects perform our I/O
+    tcp::resolver resolver{ios};
+    websocket::stream<ssl::stream<tcp::socket>> ws{ios, ctx};
+
+    // Look up the domain name
+    auto const lookup = resolver.async_resolve({host, port}, yield[ec]);
+    if(ec)
+        return fail(ec, "resolve");
+
+    // Make the connection on the IP address we get from a lookup
+    boost::asio::async_connect(ws.next_layer().next_layer(), lookup, yield[ec]);
+    if(ec)
+        return fail(ec, "connect");
+
+    // Perform the SSL handshake
+    ws.next_layer().async_handshake(ssl::stream_base::client, yield[ec]);
+    if(ec)
+        return fail(ec, "ssl_handshake");
+
+    // Perform the websocket handshake
+    ws.async_handshake(host, "/", yield[ec]);
+    if(ec)
+        return fail(ec, "handshake");
+
+    // Send the message
+    ws.async_write(boost::asio::buffer(std::string(text)), yield[ec]);
+    if(ec)
+        return fail(ec, "write");
+
+    // This buffer will hold the incoming message
+    boost::beast::multi_buffer b;
+
+    // Read a message into our buffer
+    ws.async_read(b, yield[ec]);
+    if(ec)
+        return fail(ec, "read");
+
+    // Close the WebSocket connection
+    ws.async_close(websocket::close_code::normal, yield[ec]);
+    if(ec)
+        return fail(ec, "close");
+
+    // If we get here then the connection is closed gracefully
+
+    // The buffers() function helps print a ConstBufferSequence
+    std::cout << boost::beast::buffers(b.data()) << std::endl;
+}
+
+//------------------------------------------------------------------------------
+
+int main(int argc, char** argv)
+{
+    // Check command line arguments.
+    if(argc != 4)
+    {
+        std::cerr <<
+            "Usage: websocket-client-coro-ssl <host> <port> <text>\n" <<
+            "Example:\n" <<
+            "    websocket-client-coro-ssl echo.websocket.org 443 \"Hello, world!\"\n";
+        return EXIT_FAILURE;
+    }
+    auto const host = argv[1];
+    auto const port = argv[2];
+    auto const text = argv[3];
+
+    // The io_service is required for all I/O
+    boost::asio::io_service ios;
+
+    // The SSL context is required, and holds certificates
+    ssl::context ctx{ssl::context::sslv23_client};
+
+    // This holds the root certificate used for verification
+    load_root_certificates(ctx);
+
+    // Launch the asynchronous operation
+    boost::asio::spawn(ios, std::bind(
+        &do_session,
+        std::string(host),
+        std::string(port),
+        std::string(text),
+        std::ref(ios),
+        std::ref(ctx),
+        std::placeholders::_1));
+
+    // Run the I/O service. The call will return when
+    // the get operation is complete.
+    ios.run();
+
+    return EXIT_SUCCESS;
+}