cpp-httplib/docs-src/pages/ja/cookbook/s01-handlers.md

title, order, status

title	order	status
S01. GET / POST / PUT / DELETEハンドラを登録する	20	draft

httplib::Serverでは、HTTPメソッドごとにハンドラを登録します。Get()、Post()、Put()、Delete()の各メソッドにパターンとラムダを渡すだけです。

基本の使い方

#include <httplib.h>

int main() {
  httplib::Server svr;

  svr.Get("/hello", [](const httplib::Request &req, httplib::Response &res) {
    res.set_content("Hello, World!", "text/plain");
  });

  svr.Post("/api/items", [](const httplib::Request &req, httplib::Response &res) {
    // req.bodyにリクエストボディが入っている
    res.status = 201;
    res.set_content("Created", "text/plain");
  });

  svr.Put("/api/items/1", [](const httplib::Request &req, httplib::Response &res) {
    res.set_content("Updated", "text/plain");
  });

  svr.Delete("/api/items/1", [](const httplib::Request &req, httplib::Response &res) {
    res.status = 204;
  });

  svr.listen("0.0.0.0", 8080);
}

ハンドラは(const Request&, Response&)の2引数を受け取ります。res.set_content()でレスポンスボディとContent-Typeを設定し、res.statusでステータスコードを指定します。listen()を呼ぶとサーバーが起動し、ブロックされます。

クエリパラメーターを取得する

svr.Get("/search", [](const httplib::Request &req, httplib::Response &res) {
  auto q = req.get_param_value("q");
  auto limit = req.get_param_value("limit");
  res.set_content("q=" + q + ", limit=" + limit, "text/plain");
});

req.get_param_value()でクエリ文字列の値を取り出せます。存在するかどうかを先に調べたいならreq.has_param("q")を使います。

リクエストヘッダーを読む

svr.Get("/me", [](const httplib::Request &req, httplib::Response &res) {
  auto ua = req.get_header_value("User-Agent");
  res.set_content("UA: " + ua, "text/plain");
});

レスポンスヘッダーを追加したいときはres.set_header("Name", "Value")です。

Note: listen()はブロックする関数です。別スレッドで動かしたいときはstd::threadで包むか、ノンブロッキング起動が必要ならS18. listen_after_bindで起動順序を制御するを参照してください。

パスパラメーター（/users/:id）を使いたい場合はS03. パスパラメーターを使うを参照してください。