Qtの応用 - AWS S3 - 版の履歴

Wiki: /* サンプルコード */

2025-11-21T06:20:42Z

サンプルコード

← 古い版		2025年11月21日 (金) 15:20時点における版
135行目:		135行目:
	全ての設定 (リージョン、バケット名、オブジェクトキー) を任意の設定ファイルから読み込んでいる。<br>		全ての設定 (リージョン、バケット名、オブジェクトキー) を任意の設定ファイルから読み込んでいる。<br>
	<br>		<br>
	<syntaxhighlight lang="~~c++~~">		<syntaxhighlight lang="ini">
	# config.iniファイル		# config.iniファイル

2025年11月21日 (金) 05:58にWikiによる

2025-11-21T05:58:30Z

@@ 1行目: / 1行目: @@
 == 概要 ==
+Amazon S3 (Simple Storage Service) は、AWSが提供するオブジェクトストレージサービスである。<br>
 <br><br>

Wiki: /* S3へのダウンロード */

2025-11-21T05:43:36Z

S3へのダウンロード

← 古い版		2025年11月21日 (金) 14:43時点における版
72行目:		72行目:

	== S3へのダウンロード ==		== S3へのダウンロード ==
			S3バケットからファイルをストリーム経由でダウンロードするフローを以下に示す。<br>
			# ClientConfigurationの作成
			#: AWS SDKのクライアント設定オブジェクトを生成する。
			# リージョンの設定
			#: 指定されたAWSリージョンを設定する。
			# S3クライアントの生成
			<br>
			==== S3クライアントの初期化 ====
			指定されたリージョンでS3クライアントを初期化する。<br>
			<br>
			<syntaxhighlight lang="c++">
			QString region = "<リージョン名>"

			Aws::Client::ClientConfiguration clientConfig;
			clientConfig.region = region.toStdString();
			auto s3Client = std::make_unique<Aws::S3::S3Client>(clientConfig);
			</syntaxhighlight>
			<br>
			==== アップロードフロー ====
			* bucketName
			*: ダウンロード元のS3バケット名
			* objectKey
			*: S3上でのオブジェクトキー (パス)
			* filePath
			*: ダウンロード先のローカルファイルパス
			<br>
			<syntaxhighlight lang="c++">
			// 1. GetObjectRequestの設定
			Aws::S3::Model::GetObjectRequest request;
			request.SetBucket(bucketName.toStdString());
			request.SetKey(objectKey.toStdString());

			// 2. ダウンロード実行
			auto outcome = m_s3Client->GetObject(request);

			// 3. 成功時の処理
			if (outcome.IsSuccess()) {
			// ストリームの取得
			// GetResultWithOwnership : 結果オブジェクトの所有権を取得
			auto& retrieved_file = outcome.GetResultWithOwnership().GetBody(); // ダウンロードしたデータのストリームを取得

			// ローカルファイルへの書き込み
			std::ofstream output_file(filePath.toStdString(), std::ios::binary); // ファイル書き込み時もバイナリモードを使用
			output_file << retrieved_file.rdbuf(); // ストリームバッファを直接ファイルに書き込み
			output_file.close();
			}
			</syntaxhighlight>
	<br><br>		<br><br>

Wiki: /* アップロードフロー */

2025-11-21T05:27:13Z

アップロードフロー

← 古い版		2025年11月21日 (金) 14:27時点における版
60行目:		60行目:
	// 5. アップロード実行		// 5. アップロード実行
	auto outcome = s3Client->PutObject(request);		auto outcome = s3Client->PutObject(request);
			if (outcome.IsSuccess()) { // outcome.IsSuccessメソッドは、成功 / 失敗を判定することができる
			std::cout << "✓ アップロード成功" << std::endl;
			return true;
			}
			else {
			std::cerr << "✗ アップロード失敗: " << outcome.GetError().GetMessage() << std::endl;
			return false;
			}
	</syntaxhighlight>		</syntaxhighlight>
	~~<br>~~
	~~また、outcome.IsSuccessメソッドを使用して、成功 / 失敗を判定することができる。<br>~~
	<br><br>		<br><br>

Wiki: /* S3へのアップロード */

2025-11-21T05:25:29Z

S3へのアップロード

@@ 8行目: / 8行目: @@
 == S3へのアップロード ==
+ローカルファイルをS3バケットにストリーム経由でアップロードするフローを以下に示す。<br>
 <br><br>

Wiki: /* AWS SDK for C++のインストール */

2025-11-21T05:00:27Z

AWS SDK for C++のインストール

← 古い版		2025年11月21日 (金) 14:00時点における版
5行目:		5行目:
	== AWS SDK for C++のインストール ==		== AWS SDK for C++のインストール ==
	[[Qtの応用_-_AWS\|Qtの応用_-_AWS#AWS_SDK_for_C++のインストール]]のページを参照すること。<br>		[[Qtの応用_-_AWS\|Qtの応用_-_AWS#AWS_SDK_for_C++のインストール]]のページを参照すること。<br>
			<br><br>

			== S3へのアップロード ==

			<br><br>

			== S3へのダウンロード ==

	<br><br>		<br><br>

Wiki: /* サンプルコード */

2025-11-21T04:46:34Z

サンプルコード

← 古い版		2025年11月21日 (金) 13:46時点における版
38行目:		38行目:
	<br>		<br>
	<syntaxhighlight lang="cmake">		<syntaxhighlight lang="cmake">
			# CMakeLists.txtファイル

	cmake_minimum_required(VERSION 3.16)		cmake_minimum_required(VERSION 3.16)
	project(<プロジェクト名> VERSION 1.0 LANGUAGES CXX)		project(<プロジェクト名> VERSION 1.0 LANGUAGES CXX)
59行目:		61行目:

	# 実行ファイル		# 実行ファイル
	add_executable(~~s3manager~~		add_executable(<プロジェクト名>
	main.cpp		main.cpp
	)		)
70行目:		72行目:
	)		)
	else()		else()
	target_link_libraries(~~s3manager~~		target_link_libraries(<プロジェクト名>
	Qt5::Core		Qt5::Core
	${AWSSDK_LINK_LIBRARIES}		${AWSSDK_LINK_LIBRARIES}
77行目:		79行目:

	# インストール		# インストール
	install(TARGETS ~~s3manager~~		install(TARGETS <プロジェクト名>
	RUNTIME DESTINATION bin		RUNTIME DESTINATION bin
	)		)

Wiki: /* サンプルコード */

2025-11-21T04:41:09Z

サンプルコード

@@ 35行目: / 35行目: @@
   # ダウンロード先のローカルファイルパス
   local_file=/path/to/save/file.txt
   </syntaxhighlight>
 <br>

Wiki: ページの作成:「== 概要 ==

== AWS SDK for C++のインストール == Qtの応用_-_AWS#AWS_SDK_for_C++のインストールのページを参照すること。

== サンプルコード == 以下の例では、AWS S3へのファイルアップロードとダウンロードを行っている。
全ての設定 (リージョン、バケット名、オブジェクトキー) を任意の設定ファイルから読み込んでいる…」

2025-11-21T04:20:46Z

ページの作成:「== 概要 == == AWS SDK for C++のインストール == Qtの応用_-_AWS#AWS_SDK_for_C++のインストールのページを参照すること。 == サンプルコード == 以下の例では、AWS S3へのファイルアップロードとダウンロードを行っている。 全ての設定 (リージョン、バケット名、オブジェクトキー) を任意の設定ファイルから読み込んでいる…」

新規ページ

== 概要 ==

 

== AWS SDK for C++のインストール ==
[[Qtの応用_-_AWS|Qtの応用_-_AWS#AWS_SDK_for_C++のインストール]]のページを参照すること。 
 

== サンプルコード ==
以下の例では、AWS S3へのファイルアップロードとダウンロードを行っている。 
全ての設定 (リージョン、バケット名、オブジェクトキー) を任意の設定ファイルから読み込んでいる。 
 
<syntaxhighlight lang="c++">
# config.iniファイル

[AWS]
# AWSリージョン (必須)
region=us-east-1

[S3]
# S3バケット名 (必須)
bucket=my-bucket-name

[Upload]
# アップロード時のS3オブジェクトキー
object_key=uploads/myfile.txt

# アップロードするローカルファイルのパス
local_file=/path/to/local/file.txt

[Download]
# ダウンロードするS3オブジェクトキー
object_key=downloads/myfile.txt

# ダウンロード先のローカルファイルパス
local_file=/path/to/save/file.txt
</syntaxhighlight>
 
<syntaxhighlight lang="c++">
#include <QCoreApplication>
#include <QCommandLineParser>
#include <QSettings>
#include <QFile>
#include <QFileInfo>
#include <QDebug>
#include <fstream>
#include <iostream>
#include <aws/core/Aws.h>
#include <aws/s3/S3Client.h>
#include <aws/s3/model/PutObjectRequest.h>
#include <aws/s3/model/GetObjectRequest.h>

// 設定情報を保持する構造体
struct S3Config {
QString region;
QString bucket;
QString uploadObjectKey;
QString uploadLocalFile;
QString downloadObjectKey;
QString downloadLocalFile;
};

// 設定ファイルを読み込む関数
bool loadConfig(const QString& configPath, S3Config& config)
{
QFileInfo fileInfo(configPath);
if (!fileInfo.exists()) {
std::cerr << "エラー: 設定ファイルが見つかりません: " << configPath.toStdString() << std::endl;
return false;
}

QSettings settings(configPath, QSettings::IniFormat);
settings.setIniCodec("UTF-8");

// AWS設定
settings.beginGroup("AWS");
config.region = settings.value("region").toString();
settings.endGroup();

// S3設定
settings.beginGroup("S3");
config.bucket = settings.value("bucket").toString();
settings.endGroup();

// アップロード設定
settings.beginGroup("Upload");
config.uploadObjectKey = settings.value("object_key").toString();
config.uploadLocalFile = settings.value("local_file").toString();
settings.endGroup();

// ダウンロード設定
settings.beginGroup("Download");
config.downloadObjectKey = settings.value("object_key").toString();
config.downloadLocalFile = settings.value("local_file").toString();
settings.endGroup();

// 必須項目のチェック
if (config.region.isEmpty()) {
std::cerr << "エラー: [AWS] region が設定されていません" << std::endl;
return false;
}
if (config.bucket.isEmpty()) {
std::cerr << "エラー: [S3] bucket が設定されていません" << std::endl;
return false;
}

std::cout << "設定ファイル読み込み完了: " << configPath.toStdString() << std::endl;
std::cout << " リージョン: " << config.region.toStdString() << std::endl;
std::cout << " バケット名: " << config.bucket.toStdString() << std::endl;

return true;
}

class S3Manager {
private:
std::unique_ptr<Aws::S3::S3Client> m_s3Client;

public:
S3Manager(const QString& region)
{
Aws::Client::ClientConfiguration clientConfig;
clientConfig.region = region.toStdString();
m_s3Client = std::make_unique<Aws::S3::S3Client>(clientConfig);

std::cout << "S3クライアント初期化完了 (リージョン: " << region.toStdString() << ")" << std::endl;
}

bool uploadFile(const QString& bucketName, const QString& objectKey, const QString& filePath)
{
std::cout << "\n=== アップロード開始 ===" << std::endl;
std::cout << " ローカルファイル: " << filePath.toStdString() << std::endl;
std::cout << " S3パス: s3://" << bucketName.toStdString() << "/" << objectKey.toStdString() << std::endl;

// ファイルの存在チェック
QFileInfo fileInfo(filePath);
if (!fileInfo.exists()) {
std::cerr << "エラー: ファイルが見つかりません: " << filePath.toStdString() << std::endl;
return false;
}

Aws::S3::Model::PutObjectRequest request;
request.SetBucket(bucketName.toStdString());
request.SetKey(objectKey.toStdString());

// ファイルをストリームとして読み込む
auto inputData = Aws::MakeShared<Aws::FStream>("PutObjectInputStream", filePath.toStdString().c_str(), std::ios_base::in | std::ios_base::binary);

if (!inputData->is_open()) {
std::cerr << "エラー: ファイルを開けません: " << filePath.toStdString() << std::endl;
return false;
}

request.SetBody(inputData);
request.SetContentLength(fileInfo.size());

auto outcome = m_s3Client->PutObject(request);

if (outcome.IsSuccess()) {
std::cout << "✓ アップロード成功!" << std::endl;
return true;
}
else {
std::cerr << "✗ アップロード失敗: " << outcome.GetError().GetMessage() << std::endl;
return false;
}
}

bool downloadFile(const QString& bucketName, const QString& objectKey, const QString& filePath)
{
std::cout << "\n=== ダウンロード開始 ===" << std::endl;
std::cout << " S3パス: s3://" << bucketName.toStdString() << "/" << objectKey.toStdString() << std::endl;
std::cout << " 保存先: " << filePath.toStdString() << std::endl;

Aws::S3::Model::GetObjectRequest request;
request.SetBucket(bucketName.toStdString());
request.SetKey(objectKey.toStdString());

auto outcome = m_s3Client->GetObject(request);

if (outcome.IsSuccess()) {
auto& retrieved_file = outcome.GetResultWithOwnership().GetBody();

std::ofstream output_file(filePath.toStdString(), std::ios::binary);
if (!output_file.is_open()) {
std::cerr << "エラー: 保存先ファイルを開けません: " << filePath.toStdString() << std::endl;
return false;
}

output_file << retrieved_file.rdbuf();
output_file.close();

// ファイルサイズを表示
QFileInfo fileInfo(filePath);
std::cout << "✓ ダウンロード成功! (サイズ: " << fileInfo.size() << " bytes)" << std::endl;
return true;
}
else {
std::cerr << "✗ ダウンロード失敗: " << outcome.GetError().GetMessage() << std::endl;
return false;
}
}
};

int main(int argc, char *argv[])
{
QCoreApplication app(argc, argv);
QCoreApplication::setApplicationName("AWS S3 Manager");
QCoreApplication::setApplicationVersion("1.0");

// コマンドライン引数のパーサーを設定
QCommandLineParser parser;
parser.setApplicationDescription("AWS S3ファイルアップロード・ダウンロードツール (設定ファイルベース)");
parser.addHelpOption();
parser.addVersionOption();

// オプション定義
QCommandLineOption uploadOption(QStringList() << "u" << "upload", "ファイルをアップロード");
parser.addOption(uploadOption);

QCommandLineOption downloadOption(QStringList() << "d" << "download", "ファイルをダウンロード");
parser.addOption(downloadOption);

QCommandLineOption configOption(QStringList() << "c" << "config", "設定ファイルのパス (デフォルト: config.ini)", "config", "config.ini");
parser.addOption(configOption);

parser.process(app);

// AWS SDKの初期化
Aws::SDKOptions options;
Aws::InitAPI(options);

int result = 0;

{
// 設定ファイルのパスを取得
QString configPath = parser.value(configOption);

// 設定を読み込む
S3Config config;
if (!loadConfig(configPath, config)) {
std::cerr << "\n設定ファイルの例:" << std::endl;
std::cerr << " [AWS]" << std::endl;
std::cerr << " region=ap-northeast-1" << std::endl;
std::cerr << " " << std::endl;
std::cerr << " [S3]" << std::endl;
std::cerr << " bucket=my-bucket-name" << std::endl;
std::cerr << " " << std::endl;
std::cerr << " [Upload]" << std::endl;
std::cerr << " object_key=folder/myfile.txt" << std::endl;
std::cerr << " local_file=/path/to/local/file.txt" << std::endl;
std::cerr << " " << std::endl;
std::cerr << " [Download]" << std::endl;
std::cerr << " object_key=folder/myfile.txt" << std::endl;
std::cerr << " local_file=/path/to/save/file.txt" << std::endl;
Aws::ShutdownAPI(options);
return 1;
}

// S3マネージャーを初期化
S3Manager s3Manager(config.region);

if (parser.isSet(uploadOption)) {
// アップロード
if (config.uploadObjectKey.isEmpty() || config.uploadLocalFile.isEmpty()) {
std::cerr << "エラー: [Upload] セクションに object_key と local_file が必要です" << std::endl;
result = 1;
}
else {
if (!s3Manager.uploadFile(config.bucket, config.uploadObjectKey, config.uploadLocalFile)) {
result = 1;
}
}
}
else if (parser.isSet(downloadOption)) {
// ダウンロード
if (config.downloadObjectKey.isEmpty() || config.downloadLocalFile.isEmpty()) {
std::cerr << "エラー: [Download] セクションに object_key と local_file が必要です" << std::endl;
result = 1;
}
else {
if (!s3Manager.downloadFile(config.bucket, config.downloadObjectKey, config.downloadLocalFile)) {
result = 1;
}
}
}
else {
std::cerr << "エラー: --upload または --download を指定してください" << std::endl;
parser.showHelp(1);
}
}

// AWS SDKのクリーンアップ
Aws::ShutdownAPI(options);

return result;
}
</syntaxhighlight>
 

__FORCETOC__
[[カテゴリ:Qt]]