mirror of
https://github.com/yhirose/cpp-httplib.git
synced 2026-10-14 15:23:17 +00:00
c95d799180
Reword the Japanese sentences so they read naturally, and correct the size of the llama.cpp server sources in the code reading chapter.
104 lines
4.1 KiB
Markdown
104 lines
4.1 KiB
Markdown
---
|
||
title: "S07. マルチパートデータをストリーミングで受け取る"
|
||
order: 26
|
||
status: "draft"
|
||
---
|
||
|
||
大きなファイルをアップロードするハンドラを普通に書くと、`req.body`にリクエスト全体が載ってしまいメモリを圧迫します。`HandlerWithContentReader`を使うと、ボディをチャンクごとに受け取れます。
|
||
|
||
## 基本の使い方
|
||
|
||
```cpp
|
||
svr.Post("/upload",
|
||
[](const httplib::Request &req, httplib::Response &res,
|
||
const httplib::ContentReader &content_reader) {
|
||
if (req.is_multipart_form_data()) {
|
||
content_reader(
|
||
// 各パートのヘッダー
|
||
[&](const httplib::FormData &file) {
|
||
std::cout << "name: " << file.name
|
||
<< ", filename: " << file.filename << std::endl;
|
||
return true;
|
||
},
|
||
// 各パートのボディ（複数回呼ばれる）
|
||
[&](const char *data, size_t len) {
|
||
// ここでファイルに書き出すなど
|
||
return true;
|
||
});
|
||
} else {
|
||
// 普通のリクエストボディ
|
||
content_reader([&](const char *data, size_t len) {
|
||
return true;
|
||
});
|
||
}
|
||
|
||
res.set_content("ok", "text/plain");
|
||
});
|
||
```
|
||
|
||
`content_reader`は2通りの呼び方ができます。マルチパートのときは2つのコールバック（ヘッダー用とデータ用）を渡し、そうでないときは1つのコールバックだけを渡します。
|
||
|
||
## ファイルに直接書き出す
|
||
|
||
大きなファイルをそのままディスクに書き出す例です。
|
||
|
||
```cpp
|
||
svr.Post("/upload",
|
||
[](const httplib::Request &req, httplib::Response &res,
|
||
const httplib::ContentReader &content_reader) {
|
||
std::ofstream ofs;
|
||
|
||
content_reader(
|
||
[&](const httplib::FormData &file) {
|
||
if (!file.filename.empty()) {
|
||
ofs.open("uploads/" + file.filename, std::ios::binary);
|
||
}
|
||
return static_cast<bool>(ofs);
|
||
},
|
||
[&](const char *data, size_t len) {
|
||
ofs.write(data, len);
|
||
return static_cast<bool>(ofs);
|
||
});
|
||
|
||
res.set_content("uploaded", "text/plain");
|
||
});
|
||
```
|
||
|
||
メモリには常に小さなチャンクしか載らないので、ギガバイト級のファイルでも扱えます。
|
||
|
||
## パート数は自分で数える
|
||
|
||
`CPPHTTPLIB_MULTIPART_FORM_DATA_FILE_MAX_COUNT`（デフォルト1024）というパート数の上限がありますが、これが効くのは`req.form`にすべてのパートを溜め込むバッファリング側だけです。`ContentReader`はライブラリ側で何も溜め込まないので、この上限は適用されません。
|
||
|
||
パート数に上限をつけたいときは、自分で数えてヘッダーのコールバックから`false`を返してください。パースはその場で止まります。
|
||
|
||
```cpp
|
||
svr.Post("/upload",
|
||
[](const httplib::Request &req, httplib::Response &res,
|
||
const httplib::ContentReader &content_reader) {
|
||
size_t count = 0;
|
||
|
||
auto ok = content_reader(
|
||
[&](const httplib::FormData &file) {
|
||
if (++count > 100) { return false; } // ここで打ち切る
|
||
return true;
|
||
},
|
||
[&](const char *data, size_t len) {
|
||
return true;
|
||
});
|
||
|
||
if (!ok) {
|
||
res.status = httplib::StatusCode::BadRequest_400;
|
||
return;
|
||
}
|
||
|
||
res.set_content("ok", "text/plain");
|
||
});
|
||
```
|
||
|
||
`content_reader`が`false`を返した場合、何もしなければステータスは400になります（ボディがサイズ上限を超えていたときは413）。ほかのステータスを返したいときは自分でセットしてください。ボディの残りは読まずに接続を閉じるので、送信中のクライアントには接続が切れたように見えます。
|
||
|
||
> **Warning:** `HandlerWithContentReader`を使うと、`req.body`は**空のまま**です。ボディはコールバック内で自分で処理してください。
|
||
|
||
> クライアント側でマルチパートを送る方法は[C07. ファイルをマルチパートフォームとしてアップロードする](../c07-multipart-upload)を参照してください。
|