2021-03-26 23:18:51 +01:00
|
|
|
#ifndef CPR_SESSION_H
|
|
|
|
#define CPR_SESSION_H
|
|
|
|
|
|
|
|
#include <cstdint>
|
|
|
|
#include <fstream>
|
2023-08-05 20:31:33 +02:00
|
|
|
#include <functional>
|
|
|
|
#include <future>
|
2021-03-26 23:18:51 +01:00
|
|
|
#include <memory>
|
2023-08-05 20:31:33 +02:00
|
|
|
#include <queue>
|
2021-03-26 23:18:51 +01:00
|
|
|
|
2023-08-05 20:31:33 +02:00
|
|
|
#include "cpr/accept_encoding.h"
|
|
|
|
#include "cpr/async_wrapper.h"
|
2021-03-26 23:18:51 +01:00
|
|
|
#include "cpr/auth.h"
|
|
|
|
#include "cpr/bearer.h"
|
|
|
|
#include "cpr/body.h"
|
|
|
|
#include "cpr/callback.h"
|
|
|
|
#include "cpr/connect_timeout.h"
|
|
|
|
#include "cpr/cookies.h"
|
|
|
|
#include "cpr/cprtypes.h"
|
|
|
|
#include "cpr/curlholder.h"
|
2023-08-05 20:31:33 +02:00
|
|
|
#include "cpr/http_version.h"
|
2021-08-22 19:28:37 +02:00
|
|
|
#include "cpr/interface.h"
|
2021-03-26 23:18:51 +01:00
|
|
|
#include "cpr/limit_rate.h"
|
2023-08-05 20:31:33 +02:00
|
|
|
#include "cpr/local_port.h"
|
|
|
|
#include "cpr/local_port_range.h"
|
2021-03-26 23:18:51 +01:00
|
|
|
#include "cpr/low_speed.h"
|
|
|
|
#include "cpr/multipart.h"
|
|
|
|
#include "cpr/parameters.h"
|
|
|
|
#include "cpr/payload.h"
|
|
|
|
#include "cpr/proxies.h"
|
2021-07-02 16:44:48 +02:00
|
|
|
#include "cpr/proxyauth.h"
|
2023-08-05 20:31:33 +02:00
|
|
|
#include "cpr/range.h"
|
2021-08-22 19:28:37 +02:00
|
|
|
#include "cpr/redirect.h"
|
2023-08-05 20:31:33 +02:00
|
|
|
#include "cpr/reserve_size.h"
|
|
|
|
#include "cpr/resolve.h"
|
2021-03-26 23:18:51 +01:00
|
|
|
#include "cpr/response.h"
|
|
|
|
#include "cpr/ssl_options.h"
|
|
|
|
#include "cpr/timeout.h"
|
|
|
|
#include "cpr/unix_socket.h"
|
|
|
|
#include "cpr/user_agent.h"
|
2023-08-05 20:31:33 +02:00
|
|
|
#include "cpr/util.h"
|
2021-03-26 23:18:51 +01:00
|
|
|
#include "cpr/verbose.h"
|
|
|
|
|
|
|
|
namespace cpr {
|
|
|
|
|
2023-08-05 20:31:33 +02:00
|
|
|
using AsyncResponse = AsyncWrapper<Response>;
|
|
|
|
|
|
|
|
class Interceptor;
|
|
|
|
class MultiPerform;
|
|
|
|
|
|
|
|
class Session : public std::enable_shared_from_this<Session> {
|
2021-03-26 23:18:51 +01:00
|
|
|
public:
|
|
|
|
Session();
|
|
|
|
Session(const Session& other) = delete;
|
2023-08-05 20:31:33 +02:00
|
|
|
Session(Session&& old) = default;
|
2021-03-26 23:18:51 +01:00
|
|
|
|
2023-08-05 20:31:33 +02:00
|
|
|
~Session() = default;
|
2021-03-26 23:18:51 +01:00
|
|
|
|
2023-08-05 20:31:33 +02:00
|
|
|
Session& operator=(Session&& old) noexcept = default;
|
2021-03-26 23:18:51 +01:00
|
|
|
Session& operator=(const Session& other) = delete;
|
|
|
|
|
|
|
|
void SetUrl(const Url& url);
|
|
|
|
void SetParameters(const Parameters& parameters);
|
|
|
|
void SetParameters(Parameters&& parameters);
|
|
|
|
void SetHeader(const Header& header);
|
|
|
|
void UpdateHeader(const Header& header);
|
|
|
|
void SetTimeout(const Timeout& timeout);
|
|
|
|
void SetConnectTimeout(const ConnectTimeout& timeout);
|
|
|
|
void SetAuth(const Authentication& auth);
|
2023-08-05 20:31:33 +02:00
|
|
|
// Only supported with libcurl >= 7.61.0.
|
|
|
|
// As an alternative use SetHeader and add the token manually.
|
|
|
|
#if LIBCURL_VERSION_NUM >= 0x073D00
|
|
|
|
void SetBearer(const Bearer& token);
|
|
|
|
#endif
|
2021-03-26 23:18:51 +01:00
|
|
|
void SetUserAgent(const UserAgent& ua);
|
|
|
|
void SetPayload(Payload&& payload);
|
|
|
|
void SetPayload(const Payload& payload);
|
|
|
|
void SetProxies(Proxies&& proxies);
|
|
|
|
void SetProxies(const Proxies& proxies);
|
2021-07-02 16:44:48 +02:00
|
|
|
void SetProxyAuth(ProxyAuthentication&& proxy_auth);
|
|
|
|
void SetProxyAuth(const ProxyAuthentication& proxy_auth);
|
2021-03-26 23:18:51 +01:00
|
|
|
void SetMultipart(Multipart&& multipart);
|
|
|
|
void SetMultipart(const Multipart& multipart);
|
2021-08-22 19:28:37 +02:00
|
|
|
void SetRedirect(const Redirect& redirect);
|
2021-03-26 23:18:51 +01:00
|
|
|
void SetCookies(const Cookies& cookies);
|
|
|
|
void SetBody(Body&& body);
|
|
|
|
void SetBody(const Body& body);
|
|
|
|
void SetLowSpeed(const LowSpeed& low_speed);
|
|
|
|
void SetVerifySsl(const VerifySsl& verify);
|
|
|
|
void SetUnixSocket(const UnixSocket& unix_socket);
|
|
|
|
void SetSslOptions(const SslOptions& options);
|
|
|
|
void SetReadCallback(const ReadCallback& read);
|
|
|
|
void SetHeaderCallback(const HeaderCallback& header);
|
|
|
|
void SetWriteCallback(const WriteCallback& write);
|
|
|
|
void SetProgressCallback(const ProgressCallback& progress);
|
|
|
|
void SetDebugCallback(const DebugCallback& debug);
|
|
|
|
void SetVerbose(const Verbose& verbose);
|
2021-08-22 19:28:37 +02:00
|
|
|
void SetInterface(const Interface& iface);
|
2023-08-05 20:31:33 +02:00
|
|
|
void SetLocalPort(const LocalPort& local_port);
|
|
|
|
void SetLocalPortRange(const LocalPortRange& local_port_range);
|
|
|
|
void SetHttpVersion(const HttpVersion& version);
|
|
|
|
void SetRange(const Range& range);
|
|
|
|
void SetResolve(const Resolve& resolve);
|
|
|
|
void SetResolves(const std::vector<Resolve>& resolves);
|
|
|
|
void SetMultiRange(const MultiRange& multi_range);
|
|
|
|
void SetReserveSize(const ReserveSize& reserve_size);
|
|
|
|
void SetAcceptEncoding(const AcceptEncoding& accept_encoding);
|
|
|
|
void SetAcceptEncoding(AcceptEncoding&& accept_encoding);
|
|
|
|
void SetLimitRate(const LimitRate& limit_rate);
|
|
|
|
|
|
|
|
// For cancellable requests
|
|
|
|
void SetCancellationParam(std::shared_ptr<std::atomic_bool> param);
|
2021-03-26 23:18:51 +01:00
|
|
|
|
|
|
|
// Used in templated functions
|
|
|
|
void SetOption(const Url& url);
|
|
|
|
void SetOption(const Parameters& parameters);
|
|
|
|
void SetOption(Parameters&& parameters);
|
|
|
|
void SetOption(const Header& header);
|
|
|
|
void SetOption(const Timeout& timeout);
|
|
|
|
void SetOption(const ConnectTimeout& timeout);
|
|
|
|
void SetOption(const Authentication& auth);
|
|
|
|
// Only supported with libcurl >= 7.61.0.
|
|
|
|
// As an alternative use SetHeader and add the token manually.
|
|
|
|
#if LIBCURL_VERSION_NUM >= 0x073D00
|
|
|
|
void SetOption(const Bearer& auth);
|
|
|
|
#endif
|
|
|
|
void SetOption(const UserAgent& ua);
|
|
|
|
void SetOption(Payload&& payload);
|
|
|
|
void SetOption(const Payload& payload);
|
|
|
|
void SetOption(const LimitRate& limit_rate);
|
|
|
|
void SetOption(Proxies&& proxies);
|
|
|
|
void SetOption(const Proxies& proxies);
|
2021-07-02 16:44:48 +02:00
|
|
|
void SetOption(ProxyAuthentication&& proxy_auth);
|
|
|
|
void SetOption(const ProxyAuthentication& proxy_auth);
|
2021-03-26 23:18:51 +01:00
|
|
|
void SetOption(Multipart&& multipart);
|
|
|
|
void SetOption(const Multipart& multipart);
|
2021-08-22 19:28:37 +02:00
|
|
|
void SetOption(const Redirect& redirect);
|
2021-03-26 23:18:51 +01:00
|
|
|
void SetOption(const Cookies& cookies);
|
|
|
|
void SetOption(Body&& body);
|
|
|
|
void SetOption(const Body& body);
|
|
|
|
void SetOption(const ReadCallback& read);
|
|
|
|
void SetOption(const HeaderCallback& header);
|
|
|
|
void SetOption(const WriteCallback& write);
|
|
|
|
void SetOption(const ProgressCallback& progress);
|
|
|
|
void SetOption(const DebugCallback& debug);
|
|
|
|
void SetOption(const LowSpeed& low_speed);
|
|
|
|
void SetOption(const VerifySsl& verify);
|
|
|
|
void SetOption(const Verbose& verbose);
|
|
|
|
void SetOption(const UnixSocket& unix_socket);
|
|
|
|
void SetOption(const SslOptions& options);
|
2021-08-22 19:28:37 +02:00
|
|
|
void SetOption(const Interface& iface);
|
2023-08-05 20:31:33 +02:00
|
|
|
void SetOption(const LocalPort& local_port);
|
|
|
|
void SetOption(const LocalPortRange& local_port_range);
|
|
|
|
void SetOption(const HttpVersion& version);
|
|
|
|
void SetOption(const Range& range);
|
|
|
|
void SetOption(const MultiRange& multi_range);
|
|
|
|
void SetOption(const ReserveSize& reserve_size);
|
|
|
|
void SetOption(const AcceptEncoding& accept_encoding);
|
|
|
|
void SetOption(AcceptEncoding&& accept_encoding);
|
|
|
|
void SetOption(const Resolve& resolve);
|
|
|
|
void SetOption(const std::vector<Resolve>& resolves);
|
2021-03-26 23:18:51 +01:00
|
|
|
|
2021-08-22 19:28:37 +02:00
|
|
|
cpr_off_t GetDownloadFileLength();
|
2023-08-05 20:31:33 +02:00
|
|
|
/**
|
|
|
|
* Attempt to preallocate enough memory for specified number of characters in the response string.
|
|
|
|
* Pass 0 to disable this behavior and let the response string be allocated dynamically on demand.
|
|
|
|
*
|
|
|
|
* Example:
|
|
|
|
* cpr::Session session;
|
|
|
|
* session.SetUrl(cpr::Url{"http://xxx/file"});
|
|
|
|
* session.ResponseStringReserve(1024 * 512); // Reserve space for at least 1024 * 512 characters
|
|
|
|
* cpr::Response r = session.Get();
|
|
|
|
**/
|
|
|
|
void ResponseStringReserve(size_t size);
|
2021-03-26 23:18:51 +01:00
|
|
|
Response Delete();
|
|
|
|
Response Download(const WriteCallback& write);
|
|
|
|
Response Download(std::ofstream& file);
|
|
|
|
Response Get();
|
|
|
|
Response Head();
|
|
|
|
Response Options();
|
|
|
|
Response Patch();
|
|
|
|
Response Post();
|
|
|
|
Response Put();
|
|
|
|
|
2023-08-05 20:31:33 +02:00
|
|
|
AsyncResponse GetAsync();
|
|
|
|
AsyncResponse DeleteAsync();
|
|
|
|
AsyncResponse DownloadAsync(const WriteCallback& write);
|
|
|
|
AsyncResponse DownloadAsync(std::ofstream& file);
|
|
|
|
AsyncResponse HeadAsync();
|
|
|
|
AsyncResponse OptionsAsync();
|
|
|
|
AsyncResponse PatchAsync();
|
|
|
|
AsyncResponse PostAsync();
|
|
|
|
AsyncResponse PutAsync();
|
|
|
|
|
|
|
|
template <typename Then>
|
|
|
|
auto GetCallback(Then then);
|
|
|
|
template <typename Then>
|
|
|
|
auto PostCallback(Then then);
|
|
|
|
template <typename Then>
|
|
|
|
auto PutCallback(Then then);
|
|
|
|
template <typename Then>
|
|
|
|
auto HeadCallback(Then then);
|
|
|
|
template <typename Then>
|
|
|
|
auto DeleteCallback(Then then);
|
|
|
|
template <typename Then>
|
|
|
|
auto OptionsCallback(Then then);
|
|
|
|
template <typename Then>
|
|
|
|
auto PatchCallback(Then then);
|
|
|
|
|
2021-03-26 23:18:51 +01:00
|
|
|
std::shared_ptr<CurlHolder> GetCurlHolder();
|
2023-08-05 20:31:33 +02:00
|
|
|
std::string GetFullRequestUrl();
|
2021-03-26 23:18:51 +01:00
|
|
|
|
2021-07-02 16:44:48 +02:00
|
|
|
void PrepareDelete();
|
|
|
|
void PrepareGet();
|
|
|
|
void PrepareHead();
|
|
|
|
void PrepareOptions();
|
|
|
|
void PreparePatch();
|
|
|
|
void PreparePost();
|
|
|
|
void PreparePut();
|
2023-08-05 20:31:33 +02:00
|
|
|
void PrepareDownload(const WriteCallback& write);
|
|
|
|
void PrepareDownload(std::ofstream& file);
|
2021-07-02 16:44:48 +02:00
|
|
|
Response Complete(CURLcode curl_error);
|
2023-08-05 20:31:33 +02:00
|
|
|
Response CompleteDownload(CURLcode curl_error);
|
|
|
|
|
|
|
|
void AddInterceptor(const std::shared_ptr<Interceptor>& pinterceptor);
|
|
|
|
|
|
|
|
private:
|
|
|
|
// Interceptors should be able to call the private proceed() function
|
|
|
|
friend Interceptor;
|
|
|
|
friend MultiPerform;
|
2021-07-02 16:44:48 +02:00
|
|
|
|
2023-08-05 20:31:33 +02:00
|
|
|
|
|
|
|
bool hasBodyOrPayload_{false};
|
|
|
|
bool chunkedTransferEncoding_{false};
|
|
|
|
std::shared_ptr<CurlHolder> curl_;
|
|
|
|
Url url_;
|
|
|
|
Parameters parameters_;
|
|
|
|
Proxies proxies_;
|
|
|
|
ProxyAuthentication proxyAuth_;
|
|
|
|
Header header_;
|
|
|
|
AcceptEncoding acceptEncoding_;
|
|
|
|
/**
|
|
|
|
* Will be set by the read callback.
|
|
|
|
* Ensures that the "Transfer-Encoding" is set to "chunked", if not overriden in header_.
|
|
|
|
**/
|
|
|
|
ReadCallback readcb_;
|
|
|
|
HeaderCallback headercb_;
|
|
|
|
WriteCallback writecb_;
|
|
|
|
ProgressCallback progresscb_;
|
|
|
|
DebugCallback debugcb_;
|
|
|
|
CancellationCallback cancellationcb_;
|
|
|
|
|
|
|
|
size_t response_string_reserve_size_{0};
|
|
|
|
std::string response_string_;
|
|
|
|
std::string header_string_;
|
|
|
|
std::queue<std::shared_ptr<Interceptor>> interceptors_;
|
|
|
|
bool isUsedInMultiPerform{false};
|
|
|
|
bool isCancellable{false};
|
|
|
|
|
|
|
|
Response makeDownloadRequest();
|
|
|
|
Response makeRequest();
|
|
|
|
Response proceed();
|
|
|
|
Response intercept();
|
|
|
|
void prepareCommon();
|
|
|
|
void prepareCommonDownload();
|
|
|
|
void SetHeaderInternal();
|
|
|
|
std::shared_ptr<Session> GetSharedPtrFromThis();
|
|
|
|
CURLcode DoEasyPerform();
|
2021-03-26 23:18:51 +01:00
|
|
|
};
|
|
|
|
|
2023-08-05 20:31:33 +02:00
|
|
|
template <typename Then>
|
|
|
|
auto Session::GetCallback(Then then) {
|
|
|
|
return async([shared_this = GetSharedPtrFromThis()](Then then_inner) { return then_inner(shared_this->Get()); }, std::move(then));
|
|
|
|
}
|
|
|
|
|
|
|
|
template <typename Then>
|
|
|
|
auto Session::PostCallback(Then then) {
|
|
|
|
return async([shared_this = GetSharedPtrFromThis()](Then then_inner) { return then_inner(shared_this->Post()); }, std::move(then));
|
|
|
|
}
|
|
|
|
|
|
|
|
template <typename Then>
|
|
|
|
auto Session::PutCallback(Then then) {
|
|
|
|
return async([shared_this = GetSharedPtrFromThis()](Then then_inner) { return then_inner(shared_this->Put()); }, std::move(then));
|
|
|
|
}
|
|
|
|
|
|
|
|
template <typename Then>
|
|
|
|
auto Session::HeadCallback(Then then) {
|
|
|
|
return async([shared_this = GetSharedPtrFromThis()](Then then_inner) { return then_inner(shared_this->Head()); }, std::move(then));
|
|
|
|
}
|
|
|
|
|
|
|
|
template <typename Then>
|
|
|
|
auto Session::DeleteCallback(Then then) {
|
|
|
|
return async([shared_this = GetSharedPtrFromThis()](Then then_inner) { return then_inner(shared_this->Delete()); }, std::move(then));
|
|
|
|
}
|
|
|
|
|
|
|
|
template <typename Then>
|
|
|
|
auto Session::OptionsCallback(Then then) {
|
|
|
|
return async([shared_this = GetSharedPtrFromThis()](Then then_inner) { return then_inner(shared_this->Options()); }, std::move(then));
|
|
|
|
}
|
|
|
|
|
|
|
|
template <typename Then>
|
|
|
|
auto Session::PatchCallback(Then then) {
|
|
|
|
return async([shared_this = GetSharedPtrFromThis()](Then then_inner) { return then_inner(shared_this->Patch()); }, std::move(then));
|
|
|
|
}
|
|
|
|
|
2021-03-26 23:18:51 +01:00
|
|
|
} // namespace cpr
|
|
|
|
|
|
|
|
#endif
|