You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
120 lines
3.0 KiB
C++
120 lines
3.0 KiB
C++
#ifndef WEBCC_CLIENT_SESSION_H_
|
|
#define WEBCC_CLIENT_SESSION_H_
|
|
|
|
#include <string>
|
|
#include <vector>
|
|
|
|
#include "webcc/client_pool.h"
|
|
#include "webcc/request_builder.h"
|
|
#include "webcc/response.h"
|
|
|
|
namespace webcc {
|
|
|
|
// HTTP requests session providing connection-pooling, configuration and more.
|
|
// A session shouldn't be shared by multiple threads. Please create a new
|
|
// session for each thread instead.
|
|
class ClientSession {
|
|
public:
|
|
ClientSession() {
|
|
InitHeaders();
|
|
}
|
|
|
|
~ClientSession() = default;
|
|
|
|
void set_ssl_verify(bool ssl_verify) {
|
|
ssl_verify_ = ssl_verify;
|
|
}
|
|
|
|
void set_buffer_size(std::size_t buffer_size) {
|
|
buffer_size_ = buffer_size;
|
|
}
|
|
|
|
void set_timeout(int timeout) {
|
|
if (timeout > 0) {
|
|
timeout_ = timeout;
|
|
}
|
|
}
|
|
|
|
void SetHeader(const std::string& key, const std::string& value) {
|
|
headers_.Set(key, value);
|
|
}
|
|
|
|
void set_media_type(const std::string& media_type) {
|
|
media_type_ = media_type;
|
|
}
|
|
|
|
void set_charset(const std::string& charset) {
|
|
charset_ = charset;
|
|
}
|
|
|
|
// Set authorization.
|
|
void Auth(const std::string& type, const std::string& credentials);
|
|
|
|
// Set Basic authorization.
|
|
void AuthBasic(const std::string& login, const std::string& password);
|
|
|
|
// Set Token authorization.
|
|
void AuthToken(const std::string& token);
|
|
|
|
// Send a request.
|
|
// Please use RequestBuilder to build the request.
|
|
ResponsePtr Request(RequestPtr request);
|
|
|
|
// Shortcut for GET request.
|
|
ResponsePtr Get(const std::string& url, const Strings& parameters = {},
|
|
const Strings& headers = {});
|
|
|
|
// Shortcut for HEAD request.
|
|
ResponsePtr Head(const std::string& url, const Strings& parameters = {},
|
|
const Strings& headers = {});
|
|
|
|
// Shortcut for POST request.
|
|
ResponsePtr Post(const std::string& url, std::string&& data, bool json,
|
|
const Strings& headers = {});
|
|
|
|
// Shortcut for PUT request.
|
|
ResponsePtr Put(const std::string& url, std::string&& data, bool json,
|
|
const Strings& headers = {});
|
|
|
|
// Shortcut for DELETE request.
|
|
ResponsePtr Delete(const std::string& url, const Strings& headers = {});
|
|
|
|
// Shortcut for PATCH request.
|
|
ResponsePtr Patch(const std::string& url, std::string&& data, bool json,
|
|
const Strings& headers = {});
|
|
|
|
private:
|
|
void InitHeaders();
|
|
|
|
ResponsePtr Send(RequestPtr request);
|
|
|
|
private:
|
|
// Default media type for `Content-Type` header.
|
|
// E.g., "application/json".
|
|
std::string media_type_;
|
|
|
|
// Default charset for `Content-Type` header.
|
|
// E.g., "utf-8".
|
|
std::string charset_;
|
|
|
|
// Additional headers for each request.
|
|
Headers headers_;
|
|
|
|
// Verify the certificate of the peer or not.
|
|
bool ssl_verify_ = true;
|
|
|
|
// The size of the buffer for reading response.
|
|
// 0 means default value will be used.
|
|
std::size_t buffer_size_ = 0;
|
|
|
|
// Timeout in seconds for receiving response.
|
|
int timeout_ = 0;
|
|
|
|
// Pool for Keep-Alive client connections.
|
|
ClientPool pool_;
|
|
};
|
|
|
|
} // namespace webcc
|
|
|
|
#endif // WEBCC_CLIENT_SESSION_H_
|