initial commit

2025-09-01 20:47:58 +08:00
commit 12c51b5ddb
843 changed files with 475321 additions and 0 deletions
@@ -0,0 +1,127 @@
+#ifndef BASE_OP_H
+#define BASE_OP_H
+
+#include <stdint.h>
+
+#include <map>
+#include <string>
+#include "cos_config.h"
+#include "op/cos_result.h"
+
+namespace qcloud_cos{
+
+class BaseReq;
+class BaseResp;
+
+class BaseOp {
+public:
+    /// \brief BaseOp构造函数
+    ///
+    /// \param cos_conf Cos配置
+    explicit BaseOp(const SharedConfig& cos_conf)
+        : m_config(cos_conf) {
+    }
+
+    BaseOp() {}
+
+    /// \brief BaseOp析构函数
+    ~BaseOp() {}
+
+    /// \brief 获取Cos配置
+    CosConfig GetCosConfig() const;
+
+    /// \brief 获取AppID
+    uint64_t GetAppId() const;
+
+    /// \brief 获取AccessKey
+    std::string GetAccessKey() const;
+
+    /// \brief 获取SecretKey
+    std::string GetSecretKey() const;
+
+    /// \brief 获取Token
+    std::string GetTmpToken() const;
+
+    /// \brief 封装了cos Service/Bucket/Object 相关接口的通用操作,
+    ///        包括签名计算、请求发送、返回内容解析等
+    ///
+    /// \param host     目标主机, 以http://开头
+    /// \param path     http path
+    /// \param req      http请求
+    /// \param req_body http request的body
+    /// \param resp     http返回
+    ///
+    /// \return http调用情况(状态码等)
+    CosResult NormalAction(const std::string& host,
+                           const std::string& path,
+                           const BaseReq& req,
+                           const std::string& req_body,
+                           bool check_body,
+                           BaseResp* resp);
+
+    /// \brief 封装了cos Service/Bucket/Object相关接口的通用操作,
+    ///        包括签名计算、请求发送、返回内容解析等
+    ///
+    /// \param host     目标主机, 以http://开头
+    /// \param path     http path
+    /// \param req      http请求
+    /// \param additional_headers http请求需要所需的额外header
+    /// \param additional_params  http请求需要所需的额外params
+    /// \param req_body http request的body
+    /// \param resp     http返回
+    ///
+    /// \return http调用情况(状态码等)
+    CosResult NormalAction(const std::string& host,
+                           const std::string& path,
+                           const BaseReq& req,
+                           const std::map<std::string, std::string>& additional_headers,
+                           const std::map<std::string, std::string>& additional_params,
+                           const std::string& req_body,
+                           bool check_body,
+                           BaseResp* resp);
+
+    /// \brief 下载文件并输出到流中
+    ///
+    /// \param host     目标主机, 以http://开头
+    /// \param path     http path
+    /// \param req      http请求
+    /// \param resp     http返回
+    /// \param os       输出流
+    ///
+    /// \return http调用情况(状态码等)
+    CosResult DownloadAction(const std::string& host,
+                             const std::string& path,
+                             const BaseReq& req,
+                             BaseResp* resp,
+                             std::ostream& os);
+
+    /// \brief 支持从stream中读入数据并上传
+    ///
+    /// \param host     目标主机, 以http://开头
+    /// \param path     http path
+    /// \param req      http请求
+    /// \param additional_headers http请求需要所需的额外header
+    /// \param additional_params  http请求需要所需的额外params
+    /// \param is       http request的body
+    /// \param resp     http返回
+    ///
+    /// \return http调用情况(状态码等)
+    CosResult UploadAction(const std::string& host,
+                           const std::string& path,
+                           const BaseReq& req,
+                           const std::map<std::string, std::string>& additional_headers,
+                           const std::map<std::string, std::string>& additional_params,
+                           std::istream& is,
+                           BaseResp* resp);
+
+    std::string GetRealUrl(const std::string& host,
+                           const std::string& path,
+                           bool is_https);
+
+
+protected:
+    SharedConfig m_config;
+};
+
+} // namespace qcloud_cos
+#endif