Skip to content

FinceptTerminal is a modern finance application offering advanced market analytics, investment research, and economic data tools, designed for interactive exploration and data-driven decision-making in a user-friendly environment.

3.4 KB
Raw Blame
#pragma once
#include "core/result/Result.h"

#include <QByteArray>
#include <QJsonArray>
#include <QJsonDocument>
#include <QJsonObject>
#include <QMap>
#include <QNetworkAccessManager>
#include <QNetworkReply>
#include <QObject>
#include <QString>

#include <functional>
#include <string>

namespace fincept {

/// Async HTTP client wrapping QNetworkAccessManager. Responses delivered on the Qt event loop.
class HttpClient : public QObject {
    Q_OBJECT
  public:
    static HttpClient& instance();

    using JsonCallback = std::function<void(Result<QJsonDocument>)>;

    /// Extra raw headers for one request, applied last so they override the
    /// defaults set by build_request(). This is the supported way to send a
    /// per-caller credential: this class is a process-wide singleton, so
    /// set_auth_header()/set_session_token() leak into every other caller's
    /// requests and must not be used to scope one call.
    using Headers = QMap<QByteArray, QByteArray>;

    /// `context` scopes callback lifetime — pass `this` from anything that can outlive its reply.
    /// nullptr is safe only for objects whose lifetime equals the app's (singletons).
    void get(const QString& url, JsonCallback callback, const QObject* context = nullptr,
             const Headers& extra_headers = {});
    void post(const QString& url, const QJsonObject& body, JsonCallback callback, const QObject* context = nullptr,
              const Headers& extra_headers = {});
    void put(const QString& url, const QJsonObject& body, JsonCallback callback, const QObject* context = nullptr,
             const Headers& extra_headers = {});
    void del(const QString& url, JsonCallback callback, const QObject* context = nullptr,
             const Headers& extra_headers = {});
    void del(const QString& url, const QJsonObject& body, JsonCallback callback, const QObject* context = nullptr,
             const Headers& extra_headers = {});

    /// POST `fields` as an application/x-www-form-urlencoded body, for APIs that
    /// do not accept JSON (Twilio's Messages API). The response is still parsed
    /// as JSON like every other call.
    void post_form(const QString& url, const QMap<QString, QString>& fields, JsonCallback callback,
                   const QObject* context = nullptr, const Headers& extra_headers = {});

    /// Error strings produced by this client are `"HTTP_<status>"` or
    /// `"HTTP_<status>: <server message>"`. These two recover the halves —
    /// use them instead of re-implementing the parse at each call site.
    /// status_from_error() returns 0 for transport/parse failures (no status).
    static int status_from_error(const std::string& error);
    /// Server-supplied text, or empty when the response carried none.
    /// For a non-HTTP failure (transport/JSON parse) the raw text is returned.
    static QString message_from_error(const std::string& error);

    void set_auth_header(const QString& api_key);
    void set_session_token(const QString& token);
    void clear_session_token();
    void set_base_url(const QString& base);

  private:
    HttpClient();
    QNetworkRequest build_request(const QString& url, const Headers& extra_headers = {}) const;
    void handle_reply(QNetworkReply* reply, JsonCallback callback, const QObject* context);

    QNetworkAccessManager* nam_ = nullptr;
    QString base_url_;
    QString api_key_;
    QString session_token_;
};

} // namespace fincept