Line data    Source code

       1              : //
       2              : // Copyright (c) 2025 Vinnie Falco (vinnie dot falco at gmail dot com)
       3              : //
       4              : // Distributed under the Boost Software License, Version 1.0. (See accompanying
       5              : // file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
       6              : //
       7              : // Official repository: https://github.com/cppalliance/beast2
       8              : //
       9              : 
      10              : #ifndef BOOST_BEAST2_SERVER_HTTP_SERVER_HPP
      11              : #define BOOST_BEAST2_SERVER_HTTP_SERVER_HPP
      12              : 
      13              : #include <boost/beast2/detail/config.hpp>
      14              : #include <boost/beast2/server/router_corosio.hpp>
      15              : #include <boost/capy/application.hpp>
      16              : #include <boost/corosio/endpoint.hpp>
      17              : 
      18              : namespace boost {
      19              : namespace beast2 {
      20              : 
      21              : /** An HTTP server using Corosio for I/O.
      22              : */
      23              : class http_server
      24              : {
      25              : public:
      26            0 :     virtual ~http_server() = default;
      27              : 
      28            0 :     http_server() = default;
      29              : 
      30              :     /** The router for handling HTTP requests.
      31              :     */
      32              :     router_corosio wwwroot;
      33              : 
      34              :     /** Run the server.
      35              : 
      36              :         This function attaches the current thread to the I/O context
      37              :         so that it may be used for executing operations. Blocks the
      38              :         calling thread until the server is stopped and has no
      39              :         outstanding work.
      40              :     */
      41              :     virtual void run() = 0;
      42              : 
      43              :     /** Stop the server.
      44              : 
      45              :         Signals the server to stop accepting new connections and
      46              :         cancel outstanding operations.
      47              :     */
      48              :     virtual void stop() = 0;
      49              : };
      50              : 
      51              : //------------------------------------------------
      52              : 
      53              : /** Install a plain (non-TLS) HTTP server into an application.
      54              : 
      55              :     @param app The application to install the server into.
      56              :     @param addr The address to bind to (e.g. "0.0.0.0").
      57              :     @param port The port to listen on.
      58              :     @param num_workers The number of worker sockets to preallocate.
      59              : 
      60              :     @return A reference to the installed server.
      61              : */
      62              : BOOST_BEAST2_DECL
      63              : http_server&
      64              : install_plain_http_server(
      65              :     capy::application& app,
      66              :     char const* addr,
      67              :     unsigned short port,
      68              :     std::size_t num_workers);
      69              : 
      70              : } // beast2
      71              : } // boost
      72              : 
      73              : #endif