您的位置:

cpp-httplib: 快速构建C++ Web服务

cpp-httplib 是一个C++语言编写的Web Server库,它可以帮助您在短时间内构建一个高效的Web服务应用程序。cpp-httplib使用简单,支持多种HTTP请求类型,并包含错误处理程序。本篇文章将从以下几个方面详细阐述cpp-httplib的使用方法和应用场景:

一、基本使用

1、导入cpp-httplib:

#include <httplib.h>

2、创建一个 HTTP Server:

httplib::Server svr;

3、在 HTTP Server 上注册 GET 方法:

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

4、启动 HTTP Server:

svr.listen("localhost", 1234);

上面的代码将在本地启动一个Server并监听端口号为1234,然后它将注册URI “/” 的GET方法,并返回Hello World!。

二、HTTP 请求和响应

1、根据 URI 动态获取请求的参数:

svr.Post("/submit", [](const httplib::Request &req, httplib::Response &res) {
  auto name = req.get_param_value("name");
  auto age = req.get_param_value("age");
  res.set_content("Name: " + name + ", Age: " + age, "text/plain");
});

2、通过 Query String 或 JSON 主体获取请求的数据:

svr.Post("/submit", [](const httplib::Request &req, httplib::Response &res) {
  auto qs_name = req.get_query_value("name");
  auto qs_age = req.get_query_value("age");

  nlohmann::json json;
  json["name"] = req_json.value("name", "No Name");
  json["age"] = req_json.value("age", 0);
  auto req_body = json.dump();

  res.set_content("Name: " + qs_name + ", Age: " + qs_age + ", Request Body: " + req_body, "text/plain");
});

3、设置响应头:

res.set_header("Server", "MyServer/1.0");

4、设置响应主体:

res.set_content("Hello World!", "text/plain");

三、高级功能

1、文件服务:

httplib::Server svr;
svr.set_file_extension_and_mimetype_mapping({
    {"htm", "text/html"},
    {"html", "text/html"},
    {"css", "text/css"},
    {"gif", "image/gif"},
    {"jpg", "image/jpeg"},
    {"png", "image/png"},
    {"js", "application/javascript"}
});
svr.set_mount_point("/", "./public_html");
svr.listen("localhost", 1234);

2、验证器:

struct ValidUser {
  std::string user_name, password;

  bool operator==(const ValidUser& rhs) const {
    return user_name == rhs.user_name && password == rhs.password;
  }
};

class Authenticator : public httplib::Authentication {
public:
  Authenticator() {}

  bool operator()(const httplib::Request& req) override {
    auto auth_headers = req.get_header_value("Authorization");
    if (!auth_headers.empty()) {
      auto creds = split_basic_auth_header(auth_headers);
      for (const auto& user : m_validUsers) {
        if (creds.first == user.user_name && creds.second == user.password) {
          return true;
        }
      }
    }

    return false;
  }

  void add_user(const std::string& user_name, const std::string& password) {
    m_validUsers.push_back(ValidUser{user_name, password});
  }

private:
  std::vector<ValidUser> m_validUsers;
};

httplib::Server svr;

Authenticator auth;
auth.add_user("admin", "123456");
svr.set_authenticator("localhost", auth);

svr.get("/", [](const httplib::Request& /*req*/, httplib::Response& res) {
     res.set_content("OK", "text/plain");
});

svr.listen("localhost", 1234);

四、应用场景

1、RESTful API:

cpp-httplib支持GET、POST、PUT、DELETE 以及其他HTTP请求类型,因此可轻松创建RESTful API。

2、轻量级Web服务:

cpp-httplib是一个非常轻巧的Web服务器,不需要安装其他依赖项,非常适合快速构建Web服务应用程序。

3、文件服务:

cpp-httplib可以用于提供静态文件服务,使客户端能够获取Web服务器上的文件资源。

总之,cpp-httplib 是一个更现代的、易于使用的 Web 服务器框架,它旨在帮助开发人员轻松构建高效的 Web 服务应用程序。如果你正在寻找一个灵活的、根据需要进行扩展的 Web 服务器框架,那么 cpp-httplib 可能是你需要的工具。