前言#

近期在公司接觸到其他團隊的C++專案，遇到與其他語言(GO)/系統串接的情況。有人提議將使用 stdin 讓兩個語言做溝通(實際效果也不錯，下次再分享)，但習慣使用webapi的我，突然發覺自己不曾使用過cpp去架設過api… 於是就有了這篇週末閒來無事，google了一下，找到 github 上擁有 7.6k stars 的 cpp-httplib。引用時也很方便，直接將 httplib.h 拉進自己的專案內就可以使用，真舒爽!

Library#

httplib 🔗#

A C++11 single-file header-only cross platform HTTP/HTTPS library. It’s extremely easy to setup. Just include the httplib.h file in your code!

NOTE: This library uses ‘blocking’ socket I/O. If you are looking for a library with ‘non-blocking’ socket I/O, this is not the one that you want.

開頭就提及，此 library 是 blocking socket I/O，對於 I/O 密集的 api 可能就不太適合了。

簡易範例#

NOTE: 記得建一個資料夾 lib，將 httplib.h 放進去，這樣就可以使用了，真是方便呢!!

1
#include <stdio.h>
2
#include <iostream>
3
#include "lib/httplib.h"
4
using namespace httplib;
5

6
void hello_world(const Request& req,Response& resp) {
7
  printf("%s [%s] %s, %s, %s %i \n",
8
            ctime(&my_time),
9
            req.method.c_str(),
10
            req.path.c_str(),
11
            req.remote_addr.c_str(),
12
            req.version.c_str(),
13
            req.remote_port);
14
  resp.set_content("<html><h1>Hello world.</h1></html>","text/html");
15
}
16

17
int main() {
18
  Server svr;
19
  svr.Get("/api/hello", hello_world);
20
  svr.listen("0.0.0.0", 8000);
21
  system("pause");
22
  return 0;
23
}

輸入 g++ -g main.cpp -o svr -lpthread && ./svr 編譯並執行

(如果沒安裝 g++)

1
sudo apt update
2
sudo apt install g++

安裝完成測試一下

1
g++ --version
2

3
>>> g++ (Ubuntu 9.4.0-1ubuntu1~20.04.1) 9.4.0
4
Copyright (C) 2019 Free Software Foundation, Inc.
5
This is free software; see the source for copying conditions.  There is NO
6
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

最後使用瀏覽器開啟 localhost<8000>/api/hello 即可看到 Hello world.

nlohmann/json 🔗#

based on c++11

使用範例#

NOTE: 將 json.hpp 放進 ./lib 當中，即可使用，也是很方便的~

1
#include <lib/json.hpp>
2
using json = nlohmann::json;
3

4
void json_callback(const Request& req, Response& resp) {
5
  json result{
6
        {"msg", "ok"},
7
        {"zh-tw", "你好"},
8
        {"data", 123}};
9
  resp.set_content(result.dump(), "text/plain");
10
}
11

12
int main() {
13
  Server svr;
14
  svr.Get("/api/json", json_callback);
15
  svr.listen("0.0.0.0", 8000);
16
  system("pause");
17
  return 0;
18
}