MinIO C++ SDK 使用教程

穆继宪Half-Dane

于 2024-09-14 07:42:35 发布

阅读量414

点赞数 4

本文链接：https://blog.csdn.net/gitblog_00923/article/details/142240848

版权

MinIO C++ SDK 使用教程

minio-cpp MinIO C++ Client SDK for Amazon S3 Compatible Cloud Storage 项目地址: https://gitcode.com/gh_mirrors/mi/minio-cpp

1. 项目介绍

MinIO C++ SDK 是一个用于与 Amazon S3 兼容的云存储服务进行交互的客户端库。它允许开发者通过 C++ 语言执行桶（Bucket）和对象（Object）操作，适用于任何兼容 Amazon S3 的对象存储服务。

MinIO C++ SDK 的主要功能包括：

创建和管理存储桶
上传、下载和管理对象
执行对象的元数据操作

2. 项目快速启动

2.1 环境准备

在开始之前，请确保您的开发环境满足以下要求：

CMake 3.10 或更高版本
vcpkg 包管理器
支持 C++17 的 C++ 编译器

2.2 安装 MinIO C++ SDK

您可以通过 vcpkg 安装 MinIO C++ SDK：

vcpkg install minio-cpp

2.3 使用 MinIO C++ SDK

以下是一个简单的示例，展示如何使用 MinIO C++ SDK 上传文件到 MinIO 存储桶。

#include <miniocpp/client.h>
#include <iostream>

int main(int argc, char* argv[]) {
    // 创建 S3 基础 URL
    minio::s3::BaseUrl base_url("play.min.io");

    // 创建凭证提供者
    minio::creds::StaticProvider provider(
        "Q3AM3UQ867SPQQA43P2F",
        "zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG"
    );

    // 创建 S3 客户端
    minio::s3::Client client(base_url, &provider);

    std::string bucket_name = "asiatrip";

    // 检查 'asiatrip' 桶是否存在
    bool exist;
    {
        minio::s3::BucketExistsArgs args;
        args.bucket = bucket_name;
        minio::s3::BucketExistsResponse resp = client.BucketExists(args);
        if (resp.error) {
            std::cout << "无法检查桶是否存在: " << resp.Error() << std::endl;
            return EXIT_FAILURE;
        }
        exist = resp.exist;
    }

    // 如果不存在，创建 'asiatrip' 桶
    if (!exist) {
        minio::s3::MakeBucketArgs args;
        args.bucket = bucket_name;
        minio::s3::MakeBucketResponse resp = client.MakeBucket(args);
        if (resp.error) {
            std::cout << "无法创建桶: " << resp.Error() << std::endl;
            return EXIT_FAILURE;
        }
    }

    // 上传 '/home/user/Photos/asiaphotos.zip' 文件到 'asiatrip' 桶
    minio::s3::UploadObjectArgs args;
    args.bucket = bucket_name;
    args.object = "asiaphotos-2015.zip";
    args.filename = "/home/user/Photos/asiaphotos.zip";
    minio::s3::UploadObjectResponse resp = client.UploadObject(args);
    if (resp.error) {
        std::cout << "无法上传对象: " << resp.Error() << std::endl;
        return EXIT_FAILURE;
    }

    std::cout << "'/home/user/Photos/asiaphotos.zip' 已成功上传为对象 'asiaphotos-2015.zip' 到桶 'asiatrip'" << std::endl;
    return EXIT_SUCCESS;
}