1 HTTP 数据结构

两个类均提供了

generate 成员函数，用于从请求/响应结构生成 HTTP 格式的字符串，在调用此方法后可直接通过 Socket 发送数据
parse 静态成员函数，用于从 HTTP 格式的字符串解析出请求/响应结构，在接收到 Socket 原始数据后可调用此方法进行解析

rm::Response 还提供了多种简化生成响应的成员函数，如 send、json、redirect 等。

2 HTTP 请求工具

3 Web 后端框架

RMVL 提供了 HTTP 的后端应用框架 rm::async::Webapp 。这是数据 IO 与通信模块的集大成者，设计理念参考 JavaScript 的 Express 框架，这里给出一个简单的 Web 服务器示例：

// demo.cpp
#include <iostream>
 
#include "rmvl/io/netapp.hpp"
 
using namespace rm;
 
int main(int argc, char *argv[]) {
    if (argc < 2) {
        std::cerr << "Usage: " << argv[0] << " <port>" << std::endl;
        return 1;
    }
 
    uint16_t port = static_cast<uint16_t>(std::atoi(argv[1]));
 
    async::IOContext io_context{};
 
    // 创建后端应用
    async::Webapp app(io_context);
 
    // 定义路由：以 GET 方法响应根路径请求
    app.get("/", [](const Request &req, Response &res) {
        res.send("<html><body><h1>Hello, World!</h1></body></html>");
    });
    // 定义路由：重定向示例
    app.get("/test", [](const Request &req, Response &res) {
        res.redirect("/");
    });
 
    // 创建子路由
    auto api_router = Router{};
 
    // 定义子路由：以 GET 方法响应根路径请求
    api_router.get("/", [](const Request &req, Response &res) {
        res.json({
            {"key", "value"},
            {"message", "This is a test API."},
        });
    });
    // 定义子路由：以 GET 方法响应 /name/:name 路径请求
    api_router.get("/name/:name", [](const Request &req, Response &res) {
        auto name = req.params.at("name");
        res.json({
            {"greeting", "Hello, " + name + "!"},
        });
    });
 
    // 使用 CORS 中间件允许跨域请求
    app.use(cors());
 
    // 挂载路由至 /api 路径
    app.use("/api", api_router);
 
    // 监听指定端口
    app.listen(port, [&]() {
        std::cout << "Server is running on port " << port << std::endl;
    });
 
    // 生成协程任务并执行
    co_spawn(io_context, &async::Webapp::spin, &app);
    io_context.run();
}

可以简单使用以下命令行进行编译

g++ demo.cpp -std=c++20 -I /usr/local/include/RMVL -l rmvl_io -l rmvl_core -o demo

# 如果使用的是 Windows 系统，可能需要额外链接 ws2_32 库

编译后，在终端输入

./demo 8080

即可创建 Web 后端服务，并且监听 8080 端口，可以使用 curl 工具或浏览器访问 http://localhost:8080/ 来测试服务器。

curl -s "http://localhost:8080"

会得到如下输出：

<html><body><h1>Hello, World!</h1></body></html>

同时，可以配合 jq 工具测试 JSON API：

curl -s "http://localhost:8080/api" | jq

会得到如下输出：

{
  "key": "value",
  "message": "This is a test API."
}

目录

1 HTTP 数据结构

2 HTTP 请求工具

3 Web 后端框架