// Copyright (C) Matrix Construct Developers, Authors & Contributors // Copyright (C) 2016-2018 Jason Volk // // Permission to use, copy, modify, and/or distribute this software for any // purpose with or without fee is hereby granted, provided that the above // copyright notice and this permission notice is present in all copies. // // THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR // IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED // WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE // DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, // INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES // (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR // SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) // HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, // STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING // IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE // POSSIBILITY OF SUCH DAMAGE. #pragma once #define HAVE_IRCD_SERVER_REQUEST_H /// The interface for when IRCd plays the role of client to other servers /// namespace ircd::server { struct in; struct out; struct request; } /// Request data and options related to transmitting the request. This /// is where buffers must be supplied to send data to the server. /// struct ircd::server::out { // supplied by user const_buffer head; const_buffer content; }; /// Request data and options related to the receive side of the request. /// This is where buffers are supplied to receive data from the remote /// server. /// struct ircd::server::in { // supplied by user mutable_buffer head_buffer; mutable_buffer content_buffer; // supplied by system http::response::head head; }; /// This is a handle for being a client to another server. This handle will /// attempt to find an existing connection pool for the remote server otherwise /// one will be created. Then it will multiplex your request and demultiplex /// your response with all the other requests pending in the pipelines to /// the remote. /// struct ircd::server::request :ctx::future { struct tag; struct tag *tag {nullptr}; public: server::out out; server::in in; request(const net::hostport &, server::out out, server::in in); request() = default; request(request &&) noexcept; request(const request &) = delete; request &operator=(request &&) noexcept; request &operator=(const request &) = delete; ~request() noexcept; }; /// Internal portion of the request // struct ircd::server::request::tag { server::request *request; ctx::promise p; size_t head_read {0}; size_t content_read {0}; mutable_buffer make_content_buffer() const; mutable_buffer make_head_buffer() const; const_buffer read_content(const const_buffer &, bool &done); const_buffer read_head(const const_buffer &, bool &done); public: mutable_buffer make_read_buffer() const; const_buffer read_buffer(const const_buffer &, bool &done); tag(server::request &); tag(tag &&) noexcept; tag(const tag &) = delete; tag &operator=(tag &&) noexcept; tag &operator=(const tag &) = delete; ~tag() noexcept; };