mirror of
https://github.com/yhirose/cpp-httplib.git
synced 2026-10-29 12:50:51 +00:00
Kim, Hyuk
290c4c0bbe
Through a CONNECT proxy it is the proxy that connects to the origin, and the CONNECT target was always the original hostname, so there was no way to send the tunnel to another address. set_tunnel_hostname_addr_map() sets that target on SSLClient, Client and WebSocketClient. The CONNECT request's Host follows it, including the Digest retry, while the Host header, the SNI and the certificate check inside the tunnel keep the original hostname. The map is also copied to a redirect client. set_hostname_addr_map() is deprecated in favor of set_direct_hostname_addr_map(), which behaves the same and names the connection it applies to. The two maps are independent and correspond to curl's --resolve and --connect-to; neither applies to the proxy's own address.
231 lines
7.6 KiB
Markdown
231 lines
7.6 KiB
Markdown
---
|
||
title: "What's Next"
|
||
order: 9
|
||
---
|
||
|
||
Tourお疲れさまでした！ cpp-httplibの基本はひと通り押さえましたね。でも、まだまだ便利な機能があります。Tourで取り上げなかった機能をカテゴリー別に紹介します。
|
||
|
||
## Streaming API
|
||
|
||
LLMのストリーミング応答や大きなファイルのダウンロードでは、レスポンス全体をメモリに載せたくないですよね。`stream::Get()`を使えば、データをチャンクごとに処理できます。
|
||
|
||
```cpp
|
||
httplib::Client cli("http://localhost:11434");
|
||
|
||
auto result = httplib::stream::Get(cli, "/api/generate");
|
||
|
||
if (result) {
|
||
while (result.next()) {
|
||
std::cout.write(result.data(), result.size());
|
||
}
|
||
}
|
||
```
|
||
|
||
なお、`stream::Get()`で読めるボディの大きさは、クライアントの`set_payload_max_length()`の上限（デフォルトは100MB）までです。もっと大きなファイルをダウンロードするなら、上限を引き上げるか、0を指定して無制限にしてください。
|
||
|
||
`Get()`に`content_receiver`コールバックを渡す方法もあります。こちらはKeep-Aliveと併用でき、`set_payload_max_length()`で上限を設定しない限りサイズの制限もありません。
|
||
|
||
```cpp
|
||
httplib::Client cli("http://localhost:8080");
|
||
|
||
cli.Get("/stream", [](const char *data, size_t len) {
|
||
std::cout.write(data, len);
|
||
return true;
|
||
});
|
||
```
|
||
|
||
サーバー側には`set_content_provider()`と`set_chunked_content_provider()`があります。サイズがわかっているなら前者、不明なら後者を使ってください。
|
||
|
||
```cpp
|
||
// サイズ指定あり（Content-Length が設定される）
|
||
svr.Get("/file", [](const auto &, auto &res) {
|
||
auto size = get_file_size("large.bin");
|
||
res.set_content_provider(size, "application/octet-stream",
|
||
[](size_t offset, size_t length, httplib::DataSink &sink) {
|
||
// offset から length バイト分を送る
|
||
return true;
|
||
});
|
||
});
|
||
|
||
// サイズ不明（Chunked Transfer Encoding）
|
||
svr.Get("/stream", [](const auto &, auto &res) {
|
||
res.set_chunked_content_provider("text/plain",
|
||
[](size_t offset, httplib::DataSink &sink) {
|
||
sink.write("chunk\n", 6);
|
||
return true; // 終了するときはsink.done()を呼ぶ
|
||
});
|
||
});
|
||
```
|
||
|
||
大きなファイルのアップロードには`make_file_provider()`が便利です。ファイルを全部メモリに読み込まず、ストリーミングで送れます。
|
||
|
||
```cpp
|
||
httplib::Client cli("http://localhost:8080");
|
||
|
||
auto res = cli.Post("/upload", {}, {}, {
|
||
httplib::make_file_provider("file", "/path/to/large-file.zip")
|
||
});
|
||
```
|
||
|
||
## Server-Sent Events (SSE)
|
||
|
||
SSEクライアントも用意しています。自動再接続や`Last-Event-ID`による再開にも対応しています。
|
||
|
||
```cpp
|
||
httplib::Client cli("http://localhost:8080");
|
||
httplib::sse::SSEClient sse(cli, "/events");
|
||
|
||
sse.on_message([](const httplib::sse::SSEMessage &msg) {
|
||
std::cout << msg.event << ": " << msg.data << std::endl;
|
||
});
|
||
|
||
sse.start(); // ブロッキング、自動再接続あり
|
||
```
|
||
|
||
イベントタイプごとにハンドラーを分けることもできますよ。
|
||
|
||
```cpp
|
||
sse.on_event("update", [](const httplib::sse::SSEMessage &msg) {
|
||
// "update" イベントだけ処理
|
||
});
|
||
```
|
||
|
||
## 認証
|
||
|
||
クライアントにはBasic認証、Bearer Token認証、Digest認証のヘルパーを用意しています。
|
||
|
||
```cpp
|
||
httplib::Client cli("https://api.example.com");
|
||
cli.set_basic_auth("user", "password");
|
||
cli.set_bearer_token_auth("my-token");
|
||
```
|
||
|
||
## 圧縮
|
||
|
||
gzip、Brotli、Zstandardによる圧縮・展開に対応しています。使いたい方式のマクロを定義してコンパイルしましょう。
|
||
|
||
| 圧縮方式 | マクロ定義 |
|
||
| -- | -- |
|
||
| gzip | `CPPHTTPLIB_ZLIB_SUPPORT` |
|
||
| Brotli | `CPPHTTPLIB_BROTLI_SUPPORT` |
|
||
| Zstandard | `CPPHTTPLIB_ZSTD_SUPPORT` |
|
||
|
||
```cpp
|
||
httplib::Client cli("https://example.com");
|
||
cli.set_compress(true); // リクエストボディを圧縮
|
||
cli.set_decompress(true); // レスポンスボディを展開
|
||
```
|
||
|
||
## プロキシ
|
||
|
||
HTTPプロキシ経由で接続できます。
|
||
|
||
```cpp
|
||
httplib::Client cli("https://example.com");
|
||
cli.set_proxy("proxy.example.com", 8080);
|
||
cli.set_proxy_basic_auth("user", "password");
|
||
```
|
||
|
||
## タイムアウト
|
||
|
||
接続・読み取り・書き込みのタイムアウトを個別に設定できます。
|
||
|
||
```cpp
|
||
httplib::Client cli("https://example.com");
|
||
cli.set_connection_timeout(5, 0); // 5秒
|
||
cli.set_read_timeout(10, 0); // 10秒
|
||
cli.set_write_timeout(10, 0); // 10秒
|
||
```
|
||
|
||
## Keep-Alive
|
||
|
||
同じサーバーに何度もリクエストするなら、Keep-Aliveを有効にしましょう。TCP接続を再利用するので効率的です。
|
||
|
||
```cpp
|
||
httplib::Client cli("https://example.com");
|
||
cli.set_keep_alive(true);
|
||
```
|
||
|
||
## サーバーのミドルウェア
|
||
|
||
リクエスト処理の前後にフックを挟めます。
|
||
|
||
```cpp
|
||
svr.set_pre_routing_handler([](const auto &req, auto &res) {
|
||
// すべてのリクエストの前に実行される
|
||
return httplib::Server::HandlerResponse::Unhandled; // 通常のルーティングに進む
|
||
});
|
||
|
||
svr.set_post_routing_handler([](const auto &req, auto &res) {
|
||
// レスポンスを送信する直前に実行される
|
||
res.set_header("X-Server", "cpp-httplib");
|
||
});
|
||
```
|
||
|
||
`res.user_data`を使うと、ミドルウェアからハンドラーにデータを渡せます。認証トークンのデコード結果を共有するときに便利です。
|
||
|
||
```cpp
|
||
svr.set_pre_routing_handler([](const auto &req, auto &res) {
|
||
res.user_data.set("auth_user", std::string("alice"));
|
||
return httplib::Server::HandlerResponse::Unhandled;
|
||
});
|
||
|
||
svr.Get("/me", [](const httplib::Request &req, httplib::Response &res) {
|
||
auto *user = res.user_data.get<std::string>("auth_user");
|
||
res.set_content("Hello, " + *user, "text/plain");
|
||
});
|
||
```
|
||
|
||
エラーや例外のハンドラーもカスタマイズできますよ。
|
||
|
||
```cpp
|
||
svr.set_error_handler([](const auto &req, auto &res) {
|
||
res.set_content("Custom Error Page", "text/html");
|
||
});
|
||
|
||
svr.set_exception_handler([](const auto &req, auto &res, std::exception_ptr ep) {
|
||
res.status = 500;
|
||
res.set_content("Internal Server Error", "text/plain");
|
||
});
|
||
```
|
||
|
||
## ロギング
|
||
|
||
サーバーでもクライアントでもロガーを設定できます。
|
||
|
||
```cpp
|
||
svr.set_logger([](const auto &req, const auto &res) {
|
||
std::cout << req.method << " " << req.path << " " << res.status << std::endl;
|
||
});
|
||
```
|
||
|
||
## Unix Domain Socket
|
||
|
||
TCP以外に、Unix Domain Socketでの通信にも対応しています。同じマシン上のプロセス間通信に使えます。
|
||
|
||
```cpp
|
||
// サーバー
|
||
httplib::Server svr;
|
||
svr.set_address_family(AF_UNIX);
|
||
svr.listen("/tmp/httplib.sock", 80); // ポート番号は使われない（0以外を渡す）
|
||
```
|
||
|
||
```cpp
|
||
// クライアント
|
||
httplib::Client cli("http://localhost");
|
||
cli.set_address_family(AF_UNIX);
|
||
cli.set_direct_hostname_addr_map({{"localhost", "/tmp/httplib.sock"}});
|
||
|
||
auto res = cli.Get("/");
|
||
```
|
||
|
||
## さらに詳しく
|
||
|
||
もっと詳しく知りたいときは、以下を参照してください。
|
||
|
||
- Cookbook — よくあるユースケースのレシピ集
|
||
- [README](https://github.com/yhirose/cpp-httplib/blob/master/README.md) — 全APIのリファレンス
|
||
- [README-sse](https://github.com/yhirose/cpp-httplib/blob/master/README-sse.md) — Server-Sent Eventsの使い方
|
||
- [README-stream](https://github.com/yhirose/cpp-httplib/blob/master/README-stream.md) — Streaming APIの使い方
|
||
- [README-websocket](https://github.com/yhirose/cpp-httplib/blob/master/README-websocket.md) — WebSocketサーバーの使い方
|