学懂C++（四十二）：网络编程——RESTful API：概念、原理、核心点与 C++ 实现详解

#include <httplib.h>
#include <nlohmann/json.hpp>
#include <iostream>
#include <unordered_map>

// 使用 nlohmann::json 进行 JSON 解析和生成
using json = nlohmann::json;
using namespace httplib;

// 用户结构体
struct User {
    int id;
    std::string name;
};

// 全局用户存储
std::unordered_map<int, User> users;

// 获取所有用户
void get_users(const Request& req, Response& res) {
    json j = json::array();
    for (const auto& [id, user] : users) {
        j.push_back({{"id", user.id}, {"name", user.name}});
    }
    res.set_content(j.dump(), "application/json");
}

// 获取特定用户
void get_user(const Request& req, Response& res) {
    int user_id = std::stoi(req.matches[1].str());
    if (users.find(user_id) != users.end()) {
        json j = {{"id", users[user_id].id}, {"name", users[user_id].name}};
        res.set_content(j.dump(), "application/json");
    } else {
        res.status = 404;
        res.set_content("User not found", "text/plain");
    }
}

// 创建用户
void create_user(const Request& req, Response& res) {
    auto j = json::parse(req.body);
    int id = j["id"];
    std::string name = j["name"];
    users[id] = User{id, name};
    res.status = 201;
    res.set_content("User created", "text/plain");
}

// 更新用户
void update_user(const Request& req, Response& res) {
    int user_id = std::stoi(req.matches[1].str());
    if (users.find(user_id) != users.end()) {
        auto j = json::parse(req.body);
        users[user_id].name = j["name"];
        res.set_content("User updated", "text/plain");
    } else {
        res.status = 404;
        res.set_content("User not found", "text/plain");
    }
}

// 删除用户
void delete_user(const Request& req, Response& res) {
    int user_id = std::stoi(req.matches[1].str());
    if (users.find(user_id) != users.end()) {
        users.erase(user_id);
        res.set_content("User deleted", "text/plain");
    } else {
        res.status = 404;
        res.set_content("User not found", "text/plain");
    }
}

int main() {
    Server svr;

    // 处理 GET /users 请求
    svr.Get("/users", get_users);

    // 处理 GET /users/:id 请求
    svr.Get(R"(/users/(\d+))", get_user);

    // 处理 POST /users 请求
    svr.Post("/users", create_user);

    // 处理 PUT /users/:id 请求
    svr.Put(R"(/users/(\d+))", update_user);

    // 处理 DELETE /users/:id 请求
    svr.Delete(R"(/users/(\d+))", delete_user);

    // 启动服务器
    svr.listen("0.0.0.0", 8080);

    return 0;
}

代码解析

依赖库：httplib.h 用于处理 HTTP 请求和响应，nlohmann/json.hpp 用于 JSON 解析和生成。
用户结构体：定义用户结构体 User，包含用户 ID 和姓名。
全局用户存储：使用 std::unordered_map 存储用户信息。
路由与处理函数：定义多个处理函数来响应不同的 HTTP 请求：
- get_users：处理 GET /users 请求，返回所有用户。
- get_user：处理 GET /users/:id 请求，返回特定用户。
- create_user：处理 POST /users 请求，创建新用户。
- update_user：处理 PUT /users/:id 请求，更新特定用户。
- delete_user：处理 DELETE /users/:id 请求，删除特定用户。
启动服务器：使用 svr.listen 方法启动 HTTP 服务器，监听端口 8080。

3. 运行代码

在 Linux 上

假设将代码保存为 rest_server.cpp，使用以下命令编译和运行：

# 编译代码
g++ -std=c++11 -o rest_server rest_server.cpp -lhttplib -lssl -lcrypto

# 运行服务器
./rest_server

在 Windows 上

假设将代码保存为 rest_server.cpp，使用以下命令编译和运行（需要安装 MinGW 或 MSVC 编译器）：

# 编译代码（MinGW）
g++ -std=c++11 -o rest_server rest_server.cpp -lhttplib -lssl -lcrypto

# 运行服务器
./rest_server

六、测试 RESTful API

使用 curl 或 Postman 等工具来测试以下 API：

获取所有用户：GET http://localhost:8080/users
获取特定用户：GET http://localhost:8080/users/1
创建用户：POST http://localhost:8080/users

{
    "id": 1,
    "name": "John Doe"
}

更新用户：PUT http://localhost:8080/users/1
```
{ "name": "Jane Doe" }
```
删除用户：DELETE http://localhost:8080/users/1

七、总结

本文详细介绍了 REST 和 RESTful API 的概念、原理及其与常用 HTTP 的区别。通过使用 cpp-httplib 库，我们在 C++ 中实现了一个简单的 RESTful API 服务器，提供了对用户资源的基本操作。通过这种方式，读者可以深入理解 RESTful API 的设计原则，并掌握其在 C++ 中的实现方法。

RESTful API 提供了一种简洁、高效的方式来构建 Web 服务，随着现代 Web 应用的发展，它已成为主流的设计模式。通过本文的学习，相信读者能够在自己的项目中灵活应用 RESTful API，并进一步提高自身的开发技能。

猿享天开

关注

10
点赞
踩
4

收藏

觉得还不错? 一键收藏
0
评论
学懂C++（四十二）：网络编程——RESTful API：概念、原理、核心点与 C++ 实现详解

REST（Representational State Transfer，表征状态转移）是由 Roy Fielding 在其 2000 年的博士论文中首次提出的一种架构风格。REST 是一种设计原则和约束条件的集合，它定义了一种基于 HTTP 协议的轻量级 Web 服务接口。本文详细介绍了 REST 和 RESTful API 的概念、原理及其与常用 HTTP 的区别。通过使用库，我们在 C++ 中实现了一个简单的 RESTful API 服务器，提供了对用户资源的基本操作。
复制链接

扫一扫

专栏目录