form.hpp

Go to the documentation of this file.

#pragma once
 
/// @file userver/clients/http/form.hpp
/// @brief @copybrief clients::http::Form
 
#include <memory>
#include <string>
 
#include <userver/utils/zstring_view.hpp>
 
USERVER_NAMESPACE_BEGIN
 
namespace curl {
class form;
}  // namespace curl
 
namespace clients::http {
 
/// @brief Multipart HTTP form builder
class Form final {
public:
    Form();
    ~Form();
 
    Form(const Form&) = delete;
    Form(Form&&) noexcept;
    Form& operator=(const Form&) = delete;
    Form& operator=(Form&&) noexcept;
 
    void AddContent(std::string_view key, std::string_view content);
    void AddContent(std::string_view key, std::string_view content, utils::zstring_view content_type);
 
    void AddBuffer(std::string_view key, utils::zstring_view file_name, const std::shared_ptr<std::string>& buffer);
    void AddBuffer(
        std::string_view key,
        utils::zstring_view file_name,
        const std::shared_ptr<std::string>& buffer,
        utils::zstring_view content_type
    );
 
    /// @cond
    // Call of this method will invalidate the form
    std::unique_ptr<curl::form> GetNative() &&;
    /// @endcond
 
private:
    std::unique_ptr<curl::form> impl_;
};
 
}  // namespace clients::http
 
USERVER_NAMESPACE_END