srs/trunk/src/protocol/srs_protocol_http_client.hpp
Winlin 3a29e5c550
AI: Fix naming issue for protocol module. v7.0.83 (#4482)
Co-authored-by: OSSRS-AI <winlinam@gmail.com>
2025-09-09 21:06:45 -04:00

127 lines
3.5 KiB
C++

//
// Copyright (c) 2013-2025 The SRS Authors
//
// SPDX-License-Identifier: MIT
//
#ifndef SRS_PROTOCOL_HTTP_CLIENT_HPP
#define SRS_PROTOCOL_HTTP_CLIENT_HPP
#include <srs_core.hpp>
#include <map>
#include <string>
#include <openssl/err.h>
#include <openssl/ssl.h>
#include <srs_protocol_http_stack.hpp>
#include <srs_protocol_st.hpp>
class SrsHttpUri;
class SrsHttpParser;
class ISrsHttpMessage;
class SrsStSocket;
class SrsNetworkKbps;
class SrsWallClock;
class SrsTcpClient;
// The default timeout for http client.
#define SRS_HTTP_CLIENT_TIMEOUT (30 * SRS_UTIME_SECONDS)
// The SSL client over TCP transport.
class SrsSslClient : public ISrsReader, public ISrsStreamWriter
{
private:
SrsTcpClient *transport_;
private:
SSL_CTX *ssl_ctx_;
SSL *ssl_;
BIO *bio_in_;
BIO *bio_out_;
public:
SrsSslClient(SrsTcpClient *tcp);
virtual ~SrsSslClient();
public:
virtual srs_error_t handshake(const std::string &host);
public:
virtual srs_error_t read(void *buf, size_t size, ssize_t *nread);
virtual srs_error_t write(void *buf, size_t size, ssize_t *nwrite);
};
// The client to GET/POST/PUT/DELETE over HTTP.
// @remark We will reuse the TCP transport until initialize or channel error,
// such as send/recv failed.
// Usage:
// SrsHttpClient hc;
// hc.initialize("127.0.0.1", 80, 9000);
// hc.post("/api/v1/version", "Hello world!", NULL);
class SrsHttpClient
{
private:
// The underlayer TCP transport, set to NULL when disconnect, or never not NULL when connected.
// We will disconnect transport when initialize or channel error, such as send/recv error.
SrsTcpClient *transport_;
SrsHttpParser *parser_;
std::map<std::string, std::string> headers_;
SrsNetworkKbps *kbps_;
private:
// The timeout in srs_utime_t.
srs_utime_t timeout_;
srs_utime_t recv_timeout_;
// The schema, host name or ip.
std::string schema_;
std::string host_;
int port_;
private:
SrsSslClient *ssl_transport_;
public:
SrsHttpClient();
virtual ~SrsHttpClient();
public:
// Initliaze the client, disconnect the transport, renew the HTTP parser.
// @param schema Should be http or https.
// @param tm The underlayer TCP transport timeout in srs_utime_t.
// @remark we will set default values in headers, which can be override by set_header.
virtual srs_error_t initialize(std::string schema, std::string h, int p, srs_utime_t tm = SRS_HTTP_CLIENT_TIMEOUT);
// Set HTTP request header in header[k]=v.
// @return the HTTP client itself.
virtual SrsHttpClient *set_header(std::string k, std::string v);
public:
// Post data to the uri.
// @param the path to request on.
// @param req the data post to uri. empty string to ignore.
// @param ppmsg output the http message to read the response.
// @remark user must free the ppmsg if not NULL.
virtual srs_error_t post(std::string path, std::string req, ISrsHttpMessage **ppmsg);
// Get data from the uri.
// @param the path to request on.
// @param req the data post to uri. empty string to ignore.
// @param ppmsg output the http message to read the response.
// @remark user must free the ppmsg if not NULL.
virtual srs_error_t get(std::string path, std::string req, ISrsHttpMessage **ppmsg);
public:
virtual void set_recv_timeout(srs_utime_t tm);
public:
virtual void kbps_sample(const char *label, srs_utime_t age);
private:
virtual void disconnect();
virtual srs_error_t connect();
ISrsStreamWriter *writer();
ISrsReader *reader();
};
#endif