o3de/Gems/HttpRequestor/Code/Include/HttpRequestor/HttpTextRequestParameters.h

/*
 * Copyright (c) Contributors to the Open 3D Engine Project.
 * For complete copyright and license terms please see the LICENSE at the root of this distribution.
 *
 * SPDX-License-Identifier: Apache-2.0 OR MIT
 *
 */

#include "HttpTypes.h"
#include <sstream>

namespace HttpRequestor
{
    //! Models the parameters needed to make a HTTP call and then receive the
    //! returned TEXT from the web request without parsing it.
    class TextParameters
    {
    public:
        // Initializing ctor

        //! @param URI A universal resource indicator representing an endpoint.
        //! @param method The HTTP method to configure.
        //! @param callback The callback method to receive a HTTP call's response.
        TextParameters(const AZStd::string& URI, Aws::Http::HttpMethod method, const TextCallback& callback);

        //! @param URI A universal resource indicator representing an endpoint.
        //! @param method The HTTP method to configure.
        //! @param headers A map of header names and values to use.
        //! @param callback The callback method to receive a HTTP call's response.
        TextParameters(const AZStd::string& URI, Aws::Http::HttpMethod method, const Headers& headers, const TextCallback& callback);

        //! @param URI A universal resource indicator representing an endpoint.
        //! @param method The HTTP method to configure.
        //! @param headers A map of header names and values to use.
        //! @param body An data to associate with an HTTP call.
        //! @param callback The callback method to receive a HTTP call's response.
        TextParameters(
            const AZStd::string& URI,
            Aws::Http::HttpMethod method,
            const Headers& headers,
            const AZStd::string& body,
            const TextCallback& callback);

        // Defaults
        ~TextParameters() = default;
        TextParameters(const TextParameters&) = default;
        TextParameters& operator=(const TextParameters&) = default;

        TextParameters(TextParameters&&) = default;
        TextParameters& operator=(TextParameters&&) = default;

        //! Get the URI in string form as an recipient of the HTTP connection.
        const Aws::String& GetURI() const
        {
            return m_URI;
        }

        //! Get the HTTP method configured to use for a request.
        Aws::Http::HttpMethod GetMethod() const
        {
            return m_method;
        }

        //! Get the list of extra headers to send as part of a request.
        //! @return A map of header-value pairs.
        const Headers& GetHeaders() const
        {
            return m_headers;
        }

        //! Get an input stream that can be used to send the body of a request.
        //! @return A string stream representing a request body.
        const std::shared_ptr<std::stringstream>& GetBodyStream() const
        {
            return m_bodyStream;
        }

        //! Get the callback function for processing text returned in an HTTP response.
        //! Callback functions are responsible for correctly interpreting the HTTP response code, and should communicate any
        //! failures.
        //! @return The callback function to process endpoint responses with.
        const TextCallback& GetCallback() const
        {
            return m_callback;
        }

    private:
        Aws::String m_URI;
        Aws::Http::HttpMethod m_method;
        Headers m_headers;
        std::shared_ptr<std::stringstream> m_bodyStream;
        TextCallback m_callback;
    };

    inline TextParameters::TextParameters(const AZStd::string& URI, Aws::Http::HttpMethod method, const TextCallback& callback)
        : m_URI(URI.c_str())
        , m_method(method)
        , m_callback(callback)
    {
    }

    inline TextParameters::TextParameters(
        const AZStd::string& URI, Aws::Http::HttpMethod method, const Headers& headers, const TextCallback& callback)
        : m_URI(URI.c_str())
        , m_method(method)
        , m_headers(headers)
        , m_callback(callback)
    {
    }

    inline TextParameters::TextParameters(
        const AZStd::string& URI,
        Aws::Http::HttpMethod method,
        const Headers& headers,
        const AZStd::string& body,
        const TextCallback& callback)
        : m_URI(URI.c_str())
        , m_method(method)
        , m_headers(headers)
        , m_bodyStream(std::make_shared<std::stringstream>(body.c_str()))
        , m_callback(callback)
    {
    }
} // namespace HttpRequestor