mirror of
https://github.com/yhirose/cpp-httplib.git
synced 2026-04-12 19:58:29 +00:00
57 lines
2.3 KiB
Markdown
57 lines
2.3 KiB
Markdown
---
|
||
title: "S10. Post-routing handlerでレスポンスヘッダーを追加する"
|
||
order: 29
|
||
status: "draft"
|
||
---
|
||
|
||
ハンドラが返したレスポンスに、あとから共通のヘッダーを追加したいことがあります。CORSヘッダー、セキュリティヘッダー、独自のリクエストIDなどです。こういうときは`set_post_routing_handler()`を使います。
|
||
|
||
## 基本の使い方
|
||
|
||
```cpp
|
||
svr.set_post_routing_handler(
|
||
[](const httplib::Request &req, httplib::Response &res) {
|
||
res.set_header("X-Request-ID", generate_request_id());
|
||
});
|
||
```
|
||
|
||
Post-routingハンドラは、**ルートハンドラが実行された後、レスポンスが送信される前**に呼ばれます。ここで`res.set_header()`や`res.headers.erase()`を使えば、全レスポンスに対して一括でヘッダーの追加・削除ができます。
|
||
|
||
## CORSヘッダーを付ける
|
||
|
||
よくある用途がCORSです。
|
||
|
||
```cpp
|
||
svr.set_post_routing_handler(
|
||
[](const httplib::Request &req, httplib::Response &res) {
|
||
res.set_header("Access-Control-Allow-Origin", "*");
|
||
res.set_header("Access-Control-Allow-Methods", "GET, POST, PUT, DELETE, OPTIONS");
|
||
res.set_header("Access-Control-Allow-Headers", "Content-Type, Authorization");
|
||
});
|
||
```
|
||
|
||
プリフライトリクエスト（`OPTIONS`）には別途ハンドラを登録するか、pre-routingハンドラで処理します。
|
||
|
||
```cpp
|
||
svr.Options("/.*", [](const auto &req, auto &res) {
|
||
res.status = 204;
|
||
});
|
||
```
|
||
|
||
## セキュリティヘッダーをまとめて付ける
|
||
|
||
ブラウザ向けのセキュリティヘッダーを一箇所で管理できます。
|
||
|
||
```cpp
|
||
svr.set_post_routing_handler(
|
||
[](const httplib::Request &req, httplib::Response &res) {
|
||
res.set_header("X-Content-Type-Options", "nosniff");
|
||
res.set_header("X-Frame-Options", "DENY");
|
||
res.set_header("Referrer-Policy", "strict-origin-when-cross-origin");
|
||
});
|
||
```
|
||
|
||
どのハンドラがレスポンスを作っても、同じヘッダーが付くようになります。
|
||
|
||
> **Note:** Post-routingハンドラは、ルートにマッチしなかったリクエストや、エラーハンドラが返したレスポンスに対しても呼ばれます。ヘッダーをすべてのレスポンスに確実に付けたいときに便利です。
|