Linux 网络编程实战：基于 C++ 实现 JSON+HTTP Web 计算器服务器

反序列化使用静态成员函数 parse()。C++11 引入了原始字符串字面量 R"()" 语法，方便处理包含特殊字符的 JSON 字符串。

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

原理简析

json.hpp 内部维护一个 json 类，核心成员包括类型变量与联合体形式的值变量。联合体设计使得同一时刻只能表示一种数据类型。构造函数根据输入决定类型，例如接收 std::initializer_list<std::pair> 时初始化为对象，接收 std::initializer_list<json> 时初始化为数组。

重载的 operator[] 实现了灵活的访问接口：接收 string 参数处理对象，接收 size_t 参数处理数组。同时支持隐式类型转换，如 int age = j["age"]。

HTTP 协议基础

HTTP 作为应用层协议，定义了客户端与服务端交互的规则。其本质是对请求与响应报文的格式约束。

URL 与域名解析

URL（Uniform Resource Locator）由协议、域名、端口、路径等组成。浏览器输入网址后，需先通过 DNS 解析将域名转换为 IP 地址，才能建立 TCP 连接。

HTTP 报文结构

HTTP 是文本协议，请求报文包含请求行、请求头、空行和可选的请求正文。响应报文结构类似，包含响应行、响应头、空行和响应正文。

请求方法

常见的请求方法有 GET 和 POST。GET 用于获取资源，通常不带请求正文；POST 用于提交数据，携带请求正文。其他方法如 PUT、DELETE 等也可通过 POST 映射到虚拟路径实现。

状态码

• 2xx: 成功，如 200 OK。
• 3xx: 重定向，如 301、302。
• 4xx: 客户端错误，如 400 Bad Request、404 Not Found。
• 5xx: 服务器错误，如 500 Internal Server Error。

Web 服务器实现

基于上述理论，我们使用 C++ 实现一个简单的 Web 服务器，支持静态资源访问和简单的计算功能。

架构设计

服务器整体框架遵循固定模式：创建监听套接字，绑定 IP 与端口，进入监听状态。为了解耦连接接收与业务处理，引入线程池管理任务。

Socket 封装

我们将系统接口封装为 sock 类，管理文件描述符生命周期，提供 socket、bind、listen、accept 等方法，并集成日志模块。

Httpserver 类

Httpserver 类维护 sock 对象、IP、端口及监听标志。init 函数负责创建和绑定套接字，start 函数启动监听并进入循环接受连接。

class Httpserver {
public:
    Httpserver(std::string _ip = "0.0.0.0", uint16_t _port = 80)
        : ip(_ip), port(_port), islistening(false) {}
    
    void init() {
        listen_socket.socket();
        listen_socket.bind(ip, port);
    }

    void start() {
        listen_socket.listen();
        if (islistening) return;
        islistening = true;
        threadpool& tp = threadpool::getinstance();
        tp.start();
        struct sockaddr_in client;
        socklen_t client_len = sizeof(client);
        while (islistening) {
            size_t client_fd = listen_socket.accept(&client, &client_len);
            Task t(client_fd);
            tp.push(t);
        }
    }
private:
    uint16_t port;
    std::string ip;
    sock listen_socket;
    bool islistening;
};

通信处理

读取请求

TCP 是面向字节流的，需要依据 HTTP 报文格式判断是否读取完整。HTTP 请求头结束于连续的两个 CRLF（\r\n\r\n）。我们封装 Get_HttpRequest 函数，循环读取直到找到分隔符，并根据 Content-Length 处理请求正文。

解析请求

定义 Http_Request 结构体存储解析后的字段。Deserialization 函数将请求行和请求头分割存入哈希表。

class Http_Request {
public:
    std::unordered_map<std::string, std::string> headers;
    std::string text, method, url, http_version;

    bool Deserialization(std::string& head) {
        // 分割请求头和请求行
        // ... 省略具体分割逻辑 ...
        // 使用 stringstream 解析请求行
        std::stringstream ss(first_line);
        ss >> method >> url >> http_version;
        return true;
    }
};

业务分发

根据 method 字段调用不同的处理函数：

• GET 请求：处理静态资源。根据 URL 拼接文件路径，查找文件后缀确定 MIME 类型，读取文件内容构建响应。
• POST 请求：处理动态业务。本例实现了一个计算器，解析请求体中的键值对（a, op, b），执行计算并返回结果。

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

关键代码细节

静态资源处理

Http_Get_Handler 首先判断 URL 是否为根目录，若是则默认返回 index.html。否则拼接路径读取文件。若文件不存在，返回 404 页面。

std::string Http_Get_Handler(Http_Request& hr) {
    std::string file_path;
    if (hr.url == "/" || hr.url == "/index.html") {
        file_path = path + "/index.html";
    } else {
        file_path = path + hr.url;
    }
    std::string body = read_file(file_path);
    // 构建响应报文...
    return res;
}

计算器逻辑

Http_Post_Handler 解析请求体，提取 a, op, b 三个参数。注意处理 URL 编码（如 %2B 转 +）。执行计算后构建 HTML 响应。

bool process_calculation(std::unordered_map<std::string, std::string>& val, int& result) {
    int a = std::stoi(val["a"]);
    int b = std::stoi(val["b"]);
    std::string op = val["op"];
    // 解码运算符
    if (op == "%2B") op = "+"; // ...
    switch (op[0]) {
        case '+': result = a + b; break;
        case '-': result = a - b; break;
        case '*': result = a * b; break;
        case '/': 
            if (b == 0) return false;
            result = a / b; break;
    }
    return true;
}

结语

本文从 JSON 序列化原理入手，深入讲解了 HTTP 协议细节，并通过实战代码演示了如何从零构建一个支持多线程的 C++ Web 服务器。掌握这些底层机制，有助于更好地理解网络通信的本质。