// // Copyright (c) 2016-2019 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 // #include #include #include #include #include using namespace boost::beast; //[http_snippet_1 #include using namespace boost::beast::http; //] namespace doc_http_snippets { //[http_snippet_17 // This function returns the buffer containing the next chunk body net::const_buffer get_next_chunk_body(); //] net::const_buffer get_next_chunk_body() { return {nullptr, 0}; } void fxx() { net::io_context ioc; net::any_io_executor work = net::require( ioc.get_executor(), net::execution::outstanding_work.tracked); std::thread t{[&](){ ioc.run(); }}; net::ip::tcp::socket sock{ioc}; { //[http_snippet_2 request req; req.version(11); // HTTP/1.1 req.method(verb::get); req.target("/index.htm"); req.set(field::accept, "text/html"); req.set(field::user_agent, "Beast"); //] } { //[http_snippet_3 response res; res.version(11); // HTTP/1.1 res.result(status::ok); res.set(field::server, "Beast"); res.body() = "Hello, world!"; res.prepare_payload(); //] } { //[http_snippet_4 flat_buffer buffer; // (The parser is optimized for flat buffers) request req; read(sock, buffer, req); //] } { //[http_snippet_5 flat_buffer buffer; response res; async_read(sock, buffer, res, [&](error_code ec, std::size_t bytes_transferred) { boost::ignore_unused(bytes_transferred); std::cerr << ec.message() << std::endl; }); //] } { //[http_snippet_6 // This buffer's max size is too small for much of anything flat_buffer buffer{10}; // Try to read a request error_code ec; request req; read(sock, buffer, req, ec); if(ec == http::error::buffer_overflow) std::cerr << "Buffer limit exceeded!" << std::endl; //] } { //[http_snippet_7 response res; res.version(11); res.result(status::ok); res.set(field::server, "Beast"); res.body() = "Hello, world!"; res.prepare_payload(); error_code ec; write(sock, res, ec); //] //[http_snippet_8 async_write(sock, res, [&](error_code ec, std::size_t bytes_transferred) { boost::ignore_unused(bytes_transferred); if(ec) std::cerr << ec.message() << std::endl; }); //] } { //[http_snippet_10 response res; response_serializer sr{res}; //] } { //[http_snippet_18 // Prepare an HTTP/1.1 response with a chunked body response res{status::ok, 11}; res.set(field::server, "Beast"); // Set Transfer-Encoding to "chunked". // If a Content-Length was present, it is removed. res.chunked(true); // Set up the serializer response_serializer sr{res}; // Write the header first write_header(sock, sr); // Now manually emit three chunks: net::write(sock, make_chunk(get_next_chunk_body())); net::write(sock, make_chunk(get_next_chunk_body())); net::write(sock, make_chunk(get_next_chunk_body())); // We are responsible for sending the last chunk: net::write(sock, make_chunk_last()); //] } { //[http_snippet_19 // Prepare a set of chunk extension to emit with the body chunk_extensions ext; ext.insert("mp3"); ext.insert("title", "Beale Street Blues"); ext.insert("artist", "W.C. Handy"); // Write the next chunk with the chunk extensions // The implementation will make a copy of the extensions object, // so the caller does not need to manage lifetime issues. net::write(sock, make_chunk(get_next_chunk_body(), ext)); // Write the next chunk with the chunk extensions // The implementation will make a copy of the extensions object, storing the copy // using the custom allocator, so the caller does not need to manage lifetime issues. net::write(sock, make_chunk(get_next_chunk_body(), ext, std::allocator{})); // Write the next chunk with the chunk extensions // The implementation allocates memory using the default allocator and takes ownership // of the extensions object, so the caller does not need to manage lifetime issues. // Note: ext is moved net::write(sock, make_chunk(get_next_chunk_body(), std::move(ext))); //] } { //[http_snippet_20 // Manually specify the chunk extensions. // Some of the strings contain spaces and a period and must be quoted net::write(sock, make_chunk(get_next_chunk_body(), ";mp3" ";title=\"Danny Boy\"" ";artist=\"Fred E. Weatherly\"" )); //] } { //[http_snippet_21 // Prepare a chunked HTTP/1.1 response with some trailer fields response res{status::ok, 11}; res.set(field::server, "Beast"); // Inform the client of the trailer fields we will send res.set(field::trailer, "Content-MD5, Expires"); res.chunked(true); // Serialize the header and two chunks response_serializer sr{res}; write_header(sock, sr); net::write(sock, make_chunk(get_next_chunk_body())); net::write(sock, make_chunk(get_next_chunk_body())); // Prepare the trailer fields trailer; trailer.set(field::content_md5, "f4a5c16584f03d90"); trailer.set(field::expires, "never"); // Emit the trailer in the last chunk. // The implementation will use the default allocator to create the storage for holding // the serialized fields. net::write(sock, make_chunk_last(trailer)); //] } { //[http_snippet_22 // Use a custom allocator for serializing the last chunk fields trailer; trailer.set(field::approved, "yes"); net::write(sock, make_chunk_last(trailer, std::allocator{})); //] } { //[http_snippet_23 // Manually emit a trailer. // We are responsible for ensuring that the trailer format adheres to the specification. string_view ext = "Content-MD5: f4a5c16584f03d90\r\n" "Expires: never\r\n" "\r\n"; net::write(sock, make_chunk_last(net::const_buffer{ext.data(), ext.size()})); //] } { //[http_snippet_24 // Prepare a chunked HTTP/1.1 response and send the header response res{status::ok, 11}; res.set(field::server, "Beast"); res.chunked(true); response_serializer sr{res}; write_header(sock, sr); // Obtain three body buffers up front auto const cb1 = get_next_chunk_body(); auto const cb2 = get_next_chunk_body(); auto const cb3 = get_next_chunk_body(); // Manually emit a chunk by first writing the chunk-size header with the correct size net::write(sock, chunk_header{ buffer_bytes(cb1) + buffer_bytes(cb2) + buffer_bytes(cb3)}); // And then output the chunk body in three pieces ("chunk the chunk") net::write(sock, cb1); net::write(sock, cb2); net::write(sock, cb3); // When we go this deep, we are also responsible for the terminating CRLF net::write(sock, chunk_crlf{}); //] } } // fxx() //[http_snippet_12 /** Send a message to a stream synchronously. @param stream The stream to write to. This type must support the SyncWriteStream concept. @param m The message to send. The Body type must support the BodyWriter concept. */ template< class SyncWriteStream, bool isRequest, class Body, class Fields> void send( SyncWriteStream& stream, message const& m) { // Check the template types static_assert(is_sync_write_stream::value, "SyncWriteStream type requirements not met"); static_assert(is_body_writer::value, "BodyWriter type requirements not met"); // Create the instance of serializer for the message serializer sr{m}; // Loop until the serializer is finished do { // This call guarantees it will make some // forward progress, or otherwise return an error. write_some(stream, sr); } while(! sr.is_done()); } //] //[http_snippet_13 template void print_response(SyncReadStream& stream) { static_assert(is_sync_read_stream::value, "SyncReadStream type requirements not met"); // Declare a parser for an HTTP response response_parser parser; // Read the entire message read(stream, parser); // Now print the message std::cout << parser.get() << std::endl; } //] #ifdef BOOST_MSVC //[http_snippet_14 template void print_cxx14(message const& m) { error_code ec; serializer sr{m}; do { sr.next(ec, [&sr](error_code& ec, auto const& buffer) { ec = {}; std::cout << make_printable(buffer); sr.consume(buffer_bytes(buffer)); }); } while(! ec && ! sr.is_done()); if(! ec) std::cout << std::endl; else std::cerr << ec.message() << std::endl; } //] #endif //[http_snippet_15 template struct lambda { Serializer& sr; lambda(Serializer& sr_) : sr(sr_) {} template void operator()(error_code& ec, ConstBufferSequence const& buffer) const { ec = {}; std::cout << make_printable(buffer); sr.consume(buffer_bytes(buffer)); } }; template void print(message const& m) { error_code ec; serializer sr{m}; do { sr.next(ec, lambda{sr}); } while(! ec && ! sr.is_done()); if(! ec) std::cout << std::endl; else std::cerr << ec.message() << std::endl; } //] #ifdef BOOST_MSVC //[http_snippet_16 template void split_print_cxx14(message const& m) { error_code ec; serializer sr{m}; sr.split(true); std::cout << "Header:" << std::endl; do { sr.next(ec, [&sr](error_code& ec, auto const& buffer) { ec = {}; std::cout << make_printable(buffer); sr.consume(buffer_bytes(buffer)); }); } while(! sr.is_header_done()); if(! ec && ! sr.is_done()) { std::cout << "Body:" << std::endl; do { sr.next(ec, [&sr](error_code& ec, auto const& buffer) { ec = {}; std::cout << make_printable(buffer); sr.consume(buffer_bytes(buffer)); }); } while(! ec && ! sr.is_done()); } if(ec) std::cerr << ec.message() << std::endl; } //] #endif // Highest snippet: } // doc_http_snippets