cpp-httplib v0.42.0
DRAFT

C08. ファイルを生バイナリとしてPOSTする

マルチパートではなく、ファイルの中身をそのままリクエストボディとして送りたいときがあります。S3互換APIへのアップロードや、生の画像データを受け付けるエンドポイントなどです。このときはmake_file_body()を使いましょう。

基本の使い方

httplib::Client cli("https://storage.example.com");

auto [size, provider] = httplib::make_file_body("backup.tar.gz");
if (size == 0) {
  std::cerr << "Failed to open file" << std::endl;
  return 1;
}

auto res = cli.Put("/bucket/backup.tar.gz", size,
                   provider, "application/gzip");

httplib::Client cli("https://storage.example.com");

auto [size, provider] = httplib::make_file_body("backup.tar.gz");
if (size == 0) {
  std::cerr << "Failed to open file" << std::endl;
  return 1;
}

auto res = cli.Put("/bucket/backup.tar.gz", size,
                   provider, "application/gzip");

make_file_body()はファイルサイズとContentProviderのペアを返します。そのままPost()やPut()に渡せば、ファイルの中身がリクエストボディとしてそのまま送られます。

ContentProviderはファイルをチャンクごとに読み込むので、巨大なファイルでもメモリに全体を載せません。

ファイルが開けなかったとき

make_file_body()は開けなかった場合、sizeを0、providerを空の関数オブジェクトとして返します。そのまま送信するとおかしな結果になるので、必ずsizeをチェックしてください。

Warning: make_file_body()はContent-Lengthを最初に確定させる必要があるため、ファイルサイズをあらかじめ取得します。送信中にファイルサイズが変わる可能性がある場合は、このAPIには向きません。

マルチパート形式で送りたい場合はC07. ファイルをマルチパートフォームとしてアップロードするを参照してください。

ESC