http_client.h

Go to the documentation of this file.

/*
 * Licensed to the Apache Software Foundation (ASF) under one
 * or more contributor license agreements.  See the NOTICE file
 * distributed with this work for additional information
 * regarding copyright ownership.  The ASF licenses this file
 * to you under the Apache License, Version 2.0 (the
 * "License"); you may not use this file except in compliance
 * with the License.  You may obtain a copy of the License at
 *
 *   http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing,
 * software distributed under the License is distributed on an
 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 * KIND, either express or implied.  See the License for the
 * specific language governing permissions and limitations
 * under the License.
 */
 
#pragma once
 
#include <chrono>
#include <cstdint>
#include <memory>
#include <string>
#include <unordered_map>
 
#include "iceberg/catalog/rest/iceberg_rest_export.h"
#include "iceberg/catalog/rest/type_fwd.h"
#include "iceberg/result.h"
 
 
namespace cpr {
class ConnectionPool;
}  // namespace cpr
 
namespace iceberg::rest {
 
class ICEBERG_REST_EXPORT HttpResponse {
 public:
  HttpResponse();
  HttpResponse(int32_t status_code, std::string body);
  ~HttpResponse();
 
  HttpResponse(const HttpResponse&) = delete;
  HttpResponse& operator=(const HttpResponse&) = delete;
  HttpResponse(HttpResponse&&) noexcept;
  HttpResponse& operator=(HttpResponse&&) noexcept;
 
  int32_t status_code() const;
 
  std::string body() const;
 
  std::unordered_map<std::string, std::string> headers() const;
 
 private:
  friend class HttpClient;
  class Impl;
  std::unique_ptr<Impl> impl_;
};
 
class ICEBERG_REST_EXPORT HttpClient {
 public:
  explicit HttpClient(std::unordered_map<std::string, std::string> default_headers = {},
                      std::chrono::milliseconds connection_timeout = {},
                      std::chrono::milliseconds socket_timeout = {},
                      std::optional<std::string> base_uri = std::nullopt);
  virtual ~HttpClient();
 
  HttpClient(const HttpClient&) = delete;
  HttpClient& operator=(const HttpClient&) = delete;
  HttpClient(HttpClient&&) = delete;
  HttpClient& operator=(HttpClient&&) = delete;
 
  virtual Result<HttpResponse> Get(
      const std::string& path, const std::unordered_map<std::string, std::string>& params,
      const std::unordered_map<std::string, std::string>& headers,
      const ErrorHandler& error_handler, auth::AuthSession& session);
 
  virtual Result<HttpResponse> Post(
      const std::string& path, const std::string& body,
      const std::unordered_map<std::string, std::string>& headers,
      const ErrorHandler& error_handler, auth::AuthSession& session);
 
  virtual Result<HttpResponse> PostForm(
      const std::string& path,
      const std::unordered_map<std::string, std::string>& form_data,
      const std::unordered_map<std::string, std::string>& headers,
      const ErrorHandler& error_handler, auth::AuthSession& session);
 
  virtual Result<HttpResponse> Head(
      const std::string& path,
      const std::unordered_map<std::string, std::string>& headers,
      const ErrorHandler& error_handler, auth::AuthSession& session);
 
  virtual Result<HttpResponse> Delete(
      const std::string& path, const std::unordered_map<std::string, std::string>& params,
      const std::unordered_map<std::string, std::string>& headers,
      const ErrorHandler& error_handler, auth::AuthSession& session);
 
 private:
  Result<std::string> RequestUri(const std::string& path) const;
 
  std::optional<std::string> base_uri_;
  std::unordered_map<std::string, std::string> default_headers_;
  std::chrono::milliseconds connection_timeout_;
  std::chrono::milliseconds socket_timeout_;
  std::unique_ptr<cpr::ConnectionPool> connection_pool_;
};
 
}  // namespace iceberg::rest