54 lines
1.9 KiB
C++
54 lines
1.9 KiB
C++
/*
|
|
Crafter®.Network
|
|
Copyright (C) 2026 Catcrafts®
|
|
Catcrafts.net
|
|
|
|
This library is free software; you can redistribute it and/or
|
|
modify it under the terms of the GNU Lesser General Public
|
|
License as published by the Free Software Foundation; either
|
|
version 3.0 of the License, or (at your option) any later version.
|
|
|
|
This library is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
Lesser General Public License for more details.
|
|
|
|
You should have received a copy of the GNU Lesser General Public
|
|
License along with this library; if not, write to the Free Software
|
|
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
|
|
*/
|
|
|
|
export module Crafter.Network:ClientHTTP;
|
|
import std;
|
|
import :HTTP;
|
|
import :ClientQUIC;
|
|
|
|
namespace Crafter {
|
|
// HTTP/3 client over QUIC. The constructor establishes the QUIC connection
|
|
// (TLS handshake + ALPN "h3"); each Send() opens a fresh request stream
|
|
// on the multiplexed connection. Thread-affinity: Send() is not safe to
|
|
// call from multiple threads concurrently against the same ClientHTTP,
|
|
// but distinct ClientHTTP instances are independent.
|
|
//
|
|
// For local development against a self-signed listener, pass
|
|
// QUICClientCredentials{insecureNoServerValidation = true}.
|
|
export class ClientHTTP {
|
|
public:
|
|
std::string host;
|
|
std::uint16_t port;
|
|
|
|
ClientHTTP(const char* host, std::uint16_t port, QUICClientCredentials creds = {});
|
|
ClientHTTP(std::string host, std::uint16_t port, QUICClientCredentials creds = {});
|
|
|
|
~ClientHTTP();
|
|
ClientHTTP(const ClientHTTP&) = delete;
|
|
ClientHTTP(ClientHTTP&&) noexcept;
|
|
|
|
// Send a request and synchronously read back the full response.
|
|
HTTPResponse Send(const HTTPRequest& request);
|
|
|
|
private:
|
|
struct Impl;
|
|
std::unique_ptr<Impl> impl;
|
|
};
|
|
}
|