Files
scylladb/protocol_server.hh
Nadav Har'El da6a126d79 cross-tree: fix header file self-sufficiency
Scylla's coding standard requires that each header is self-sufficient,
i.e., it includes whatever other headers it needs - so it can be included
without having to include any other header before it.

We have a test for this, "ninja dev-headers", but it isn't run very
frequently, and it turns out our code deviated from this requirement
in a few places. This patch fixes those places, and after it
"ninja dev-headers" succeeds again.

This is needed because our CI runs "ninja dev-headers".

Fixes #10995

Signed-off-by: Nadav Har'El <nyh@scylladb.com>

Closes #11457
2022-09-06 15:45:34 +03:00

40 lines
1.4 KiB
C++

/*
* Copyright (C) 2021-present ScyllaDB
*/
/*
* SPDX-License-Identifier: AGPL-3.0-or-later
*/
#pragma once
#include "seastarx.hh"
#include <seastar/core/future.hh>
#include <seastar/net/socket_defs.hh>
#include <vector>
// Abstraction for a server serving some kind of user-facing protocol.
class protocol_server {
public:
virtual ~protocol_server() = default;
/// Name of the server, can be different or the same as than the protocol it serves.
virtual sstring name() const = 0;
/// Name of the protocol served.
virtual sstring protocol() const = 0;
/// Version of the protocol served (if any -- not all protocols are versioned).
virtual sstring protocol_version() const = 0;
/// Addresses the server is listening on, shall be empty when server is not running.
virtual std::vector<socket_address> listen_addresses() const = 0;
/// Start the server.
/// Can be called multiple times, in any state of the server.
virtual future<> start_server() = 0;
/// Stop the server.
/// Can be called multiple times, in any state of the server.
/// This variant is used on shutdown and therefore it must succeed.
virtual future<> stop_server() = 0;
/// Stop the server. Weaker variant of \ref stop_server().
/// Can be called multiple times, in any state of the server.
/// This variant is used by the REST API so failure is acceptable.
virtual future<> request_stop_server() = 0;
};