C++ 实现 JSON+HTTP Web 服务器与计算器实战

dump() 函数用于序列化，默认紧凑格式。传入整数参数可指定缩进级别，便于调试。

反序列化

使用静态成员函数 parse() 将 JSON 字符串还原为对象。

std::string s = R"({"name":"WZ","age":18})";
nlohmann::json j = nlohmann::json::parse(s);

C++11 原始字符串字面量 R"()" 可避免转义字符的繁琐处理。

原理简析

json 类内部维护类型标签和联合体值变量。联合体设计使得同一时刻只能存储一种数据类型，节省内存。复杂类型（如对象、数组）存储指针，基本类型直接存储值。

operator[] 重载实现了类似字典和列表的访问方式。若键不存在，会自动创建对应类型的空对象，极大简化了嵌套结构的构建。

HTTP 协议详解

HTTP 是基于 TCP 的应用层协议，定义了客户端与服务端交互的规则。理解其报文结构是实现 Web 服务器的关键。

URL 与域名解析

URL（统一资源定位符）包含协议、域名、端口、路径等信息。浏览器输入网址后，需先通过 DNS 将域名解析为 IP 地址，才能建立连接。

请求报文

请求报文由四部分组成：请求行、请求头、空行、请求正文。

• 请求行：方法（GET/POST）、URL、协议版本。
• 请求头：键值对，包含 Host、User-Agent、Content-Type 等。
• 空行：\r\n\r\n 标记头部结束。
• 正文：可选，POST 请求常携带表单数据。

GET 与 POST 区别

GET 适合查询，POST 适合提交敏感或大量数据。表单数据在 POST 中通常以 application/x-www-form-urlencoded 或 multipart/form-data 格式编码。

响应报文

响应报文结构与请求对称，包含响应行、响应头、空行、响应正文。

• 响应行：协议版本、状态码（200 OK, 404 Not Found 等）、描述。
• 响应头：Content-Type、Content-Length、Set-Cookie 等。

状态码首位代表类别：1xx 信息，2xx 成功，3xx 重定向，4xx 客户端错误，5xx 服务端错误。

Web 服务器实战

基于上述理论，我们使用 C++ 从零实现一个支持计算功能的 Web 服务器。

架构设计

服务器采用面向对象设计，封装 Socket 操作、线程池管理及业务逻辑。

1. Socket 封装：统一管理文件描述符，利用 RAII 机制自动释放资源。
2. 线程池：解决接收连接与处理通信的解耦，避免频繁创建销毁线程。
3. 任务分发：根据 HTTP 方法路由到静态资源处理或动态计算逻辑。

核心代码实现

Socket 封装类

class sock {
public:
    int socketfd = -1;
    ~sock() { if(socketfd >= 0) ::close(socketfd); }
    
    void socket() {
        socketfd = ::socket(AF_INET, SOCK_STREAM, 0);
        // 设置 SO_REUSEADDR 避免重启时端口占用
        int opt = 1; setsockopt(socketfd, SOL_SOCKET, SO_REUSEADDR, &opt, sizeof(opt));
    }
    
    void bind(std::string ip, uint16_t port) {
        struct sockaddr_in server;
        memset(&server, 0, sizeof(server));
        server.sin_family = AF_INET;
        server.sin_port = htons(port);
        inet_pton(AF_INET, ip.c_str(), &server.sin_addr);
        ::bind(socketfd, (struct sockaddr*)&server, sizeof(server));
    }
    
    void listen() { ::listen(socketfd, 5); }
    
    int accept(struct sockaddr_in* client, socklen_t* len) {
        return ::accept(socketfd, (struct sockaddr*)client, len);
    }
};

HTTP 请求解析

TCP 是流式协议，需处理粘包。通过查找 \r\n\r\n 判断请求头结束，再根据 Content-Length 读取正文。

bool Get_HttpRequest(size_t socketfd, Http_Request& hr) {
    std::string data;
    char buffer[BUFFER_SIZE];
    while(true) {
        ssize_t read_bytes = recv(socketfd, buffer, BUFFER_SIZE - 1, 0);
        if(read_bytes <= 0) return false;
        data.append(buffer, read_bytes);
        if(data.find("\r\n\r\n") != std::string::npos) break;
    }
    // 分离头部与正文
    size_t head_end = data.find("\r\n\r\n") + 4;
    std::string head = data.substr(0, head_end);
    // 解析 Content-Length 并读取剩余正文...
    return hr.Deserialization(head);
}

业务处理逻辑

• GET 请求：映射到文件系统，返回静态资源（HTML/CSS/图片）。根据后缀名设置 MIME 类型。
• POST 请求：解析表单数据，执行计算器逻辑。

std::string Http_Get_Handler(Http_Request& hr) {
    std::string file_path = "./wwwroot" + hr.url;
    // 首页处理
    if(hr.url == "/" || hr.url == "/index.html") file_path += "/index.html";
    
    std::string body = read_file(file_path);
    if(body.empty()) {
        // 返回 404
        return "HTTP/1.0 404 Not Found\r\n...";
    }
    // 构建 200 OK 响应
    return "HTTP/1.0 200 OK\r\nContent-Type: text/html\r\n\r\n" + body;
}

std::string Http_Post_Handler(Http_Request& hr) {
    if(hr.url != "/calc") return process_bad_request();
    
    // 解析 key=value&key=value 格式
    std::unordered_map<std::string, std::string> val;
    // ... 解析逻辑 ...
    
    int result;
    if(!process_calculation(val, result)) return process_bad_request();
    
    // 返回计算结果 HTML
    return "HTTP/1.0 200 OK\r\n...<p>结果为：" + std::to_string(result) + "</p>...";
}

线程池管理

主循环接受连接后，将任务封装为 Task 对象推入线程池队列。工作线程从队列获取任务并执行 run() 方法，实现并发处理。

class Task {
    int socketfd;
public:
    void run() {
        Http_Request hr;
        if(!Get_HttpRequest(socketfd, hr)) return;
        
        std::string res;
        if(hr.method == "GET") res = Http_Get_Handler(hr);
        else if(hr.method == "POST") res = Http_Post_Handler(hr);
        else return;
        
        send(socketfd, res.c_str(), res.size(), 0);
        close(socketfd);
    }
};

总结

本文从序列化原理入手，深入讲解了 JSON 与 HTTP 协议的核心细节，并通过 C++ 实战演示了如何构建一个具备静态托管与动态计算能力的 Web 服务器。关键点包括：

1. 协议解析：正确处理 TCP 粘包与 HTTP 报文边界。
2. 资源管理：利用 RAII 和线程池优化资源开销。
3. 业务扩展：通过虚拟路径映射实现动态功能。

掌握这些底层机制，有助于更好地理解和优化网络应用服务。