Class Server

include/process/http.hpp:1054–1168

class Server
{
public:
  // Options for creating a server.
  //
  // NOTE: until GCC 5.0 default member initializers prevented the
  // class from being an aggregate which prevented you from being able
  // to use aggregate initialization, thus we introduce and use
  // `DEFAULT_CREATE_OPTIONS` for the default parameter of `create`.
  struct CreateOptions
  {
    Scheme scheme;
    size_t backlog;
  };

  static CreateOptions DEFAULT_CREATE_OPTIONS()
  {
    return {
      /* .scheme = */ Scheme::HTTP,
      /* .backlog = */ 16384,
    };
  };

  // Options for stopping a server.
  //
  // NOTE: see note above as to why we have `DEFAULT_STOP_OPTIONS`.
  struct StopOptions
  {
    // During the grace period:
    //   * No new sockets will be accepted (but on OS X they'll still queue).
    //   * Existing sockets will be shut down for reads to prevent new
    //     requests from arriving.
    //   * Existing sockets will be shut down after already received
    //     requests have their responses sent.
    // After the grace period connections will be forcibly shut down.
    Duration grace_period;
  };

  static StopOptions DEFAULT_STOP_OPTIONS()
  {
    return {
      /* .grace_period = */ Seconds(0),
    };
  };

  static Try<Server> create(
      network::Socket socket,
      std::function<Future<Response>(
          const network::Socket& socket,
          const Request&)>&& f,
      const CreateOptions& options = DEFAULT_CREATE_OPTIONS());

  template <typename F>
  static Try<Server> create(
      network::Socket socket,
      F&& f,
      const CreateOptions& options = DEFAULT_CREATE_OPTIONS())
  {