// Copyright (C) 2017 Internet Systems Consortium, Inc. ("ISC") // // This Source Code Form is subject to the terms of the Mozilla Public // License, v. 2.0. If a copy of the MPL was not distributed with this // file, You can obtain one at http://mozilla.org/MPL/2.0/. #ifndef HTTP_CONNECTION_POOL_H #define HTTP_CONNECTION_POOL_H #include #include namespace isc { namespace http { /// @brief Pool of active HTTP connections. /// /// The HTTP server is designed to handle many connections simultaneously. /// The communication between the client and the server may take long time /// and the server must be able to react on other events while the communication /// with the clients is in progress. Thus, the server must track active /// connections and gracefully close them when needed. An obvious case when the /// connections must be terminated by the server is when the shutdown signal /// is received. /// /// This object is a simple container for the server connections which provides /// means to terminate them on request. class HttpConnectionPool { public: /// @brief Start new connection. /// /// The connection is inserted to the pool and the /// @ref HttpConnection::asyncAccept is invoked. /// /// @param connection Pointer to the new connection. void start(const HttpConnectionPtr& connection); /// @brief Stops a connection and removes it from the pool. /// /// If the connection is not found in the pool, this method is no-op. /// /// @param connection Pointer to the connection. void stop(const HttpConnectionPtr& connection); /// @brief Stops all connections and removes them from the pool. void stopAll(); protected: /// @brief Set of connections. std::set connections_; }; } } #endif