综合实战：构建一个基于回调的微型Web服务器框架

说实话，讲到这里，我觉得是时候把前面学的函数指针和回调机制，真正揉到一起干一票大的了。

很多初学者学完回调函数，总觉得这东西挺玄乎——不就是把函数地址传来传去吗？但真到用的时候，又不知道往哪儿使。我个人习惯是，学一个技术点，最好能立刻看到它在一个完整系统里是怎么跑的。所以这一章，咱们就手撸一个微型Web服务器框架。

别一听「Web服务器」就觉得高大上。说白了，它就是个死循环，等着客户端连上来，然后根据请求的URL，调用不同的处理函数。而这个「调用不同的处理函数」，就是回调机制最经典的落地场景。

1. 核心设计思路

我当年第一次写类似的东西，是在一个嵌入式设备上做HTTP配置接口。设备资源有限，没法上完整的HTTP服务器库。怎么办？自己写一个轻量级的。核心思路就一句话：

把URL路径和处理函数绑定起来，请求来了，查表，回调。

你想想看，这不就是函数指针数组的典型应用吗？

整个框架分三层：

• 底层Socket通信层：负责监听端口、接受连接、收发数据。这部分跟业务无关。
• 路由注册层：维护一张表，记录URL路径和对应的回调函数指针。
• 请求分发层：解析HTTP请求，提取路径，查表，调用回调。

2. 定义回调函数类型

第一步，先把回调函数的「样子」定下来。在C语言里，就是用typedef定义一个函数指针类型。

// 回调函数类型定义
// 参数：请求路径、查询参数、输出缓冲区、缓冲区大小
// 返回值：0表示成功，-1表示失败
typedef int (*http_handler_t)(const char *path, 
                               const char *query,
                               char *out_buf, 
                               int buf_size);

为什么这么定义？我解释一下：

• path：请求的URL路径，比如"/led/on"。
• query：查询字符串，比如"?time=1000"。
• out_buf：输出缓冲区，回调函数把响应内容填到这里。
• buf_size：缓冲区大小，防止溢出。

3. 路由表设计与注册

路由表本质上就是一个结构体数组，每个元素存一个路径和一个函数指针。

#define MAX_ROUTES 32

typedef struct {
    const char *path;          // URL路径
    http_handler_t handler;    // 回调函数指针
} route_entry_t;

// 路由表
static route_entry_t route_table[MAX_ROUTES];
static int route_count = 0;

// 注册路由
int register_route(const char *path, http_handler_t handler) {
    if (route_count >= MAX_ROUTES) {
        return -1;  // 表满了
    }
    route_table[route_count].path = path;
    route_table[route_count].handler = handler;
    route_count++;
    return 0;
}

嗯，这里要注意：path 直接存了指针，没有拷贝字符串。这意味着传入的字符串必须在整个程序生命周期内有效。我建议用静态字符串或者常量字符串。

4. 请求分发核心

分发函数是整个框架的心脏。它接收原始HTTP请求，解析出路径，然后查表调用对应的回调。

// 分发HTTP请求
int dispatch_request(const char *http_request, char *response, int resp_size) {
    char path[128] = {0};
    char query[128] = {0};
    
    // 解析HTTP请求行：GET /led/on?time=1000 HTTP/1.1
    // 简化版解析，实际项目要用更健壮的解析器
    sscanf(http_request, "GET /%[^? \r\n]?%[^ \r\n]", path, query);
    
    // 补回前面的斜杠
    char full_path[136];
    snprintf(full_path, sizeof(full_path), "/%s", path);
    
    // 查路由表
    for (int i = 0; i < route_count; i++) {
        if (strcmp(full_path, route_table[i].path) == 0) {
            // 找到了！调用回调函数
            return route_table[i].handler(full_path, query, response, resp_size);
        }
    }
    
    // 没找到，返回404
    snprintf(response, resp_size, 
             "HTTP/1.1 404 Not Found\r\nContent-Type: text/plain\r\n\r\n404 Not Found");
    return 0;
}

5. 编写具体的回调处理函数

框架搭好了，现在来写几个具体的回调函数。假设我们要控制两个LED灯：

// LED控制回调
int led_on_handler(const char *path, const char *query, 
                   char *out_buf, int buf_size) {
    // 这里可以写真正的硬件控制代码
    // 比如：GPIO_SetLevel(LED_PIN, 1);
    snprintf(out_buf, buf_size,
             "HTTP/1.1 200 OK\r\n"
             "Content-Type: text/plain\r\n\r\n"
             "LED is ON");
    return 0;
}

int led_off_handler(const char *path, const char *query,
                    char *out_buf, int buf_size) {
    snprintf(out_buf, buf_size,
             "HTTP/1.1 200 OK\r\n"
             "Content-Type: text/plain\r\n\r\n"
             "LED is OFF");
    return 0;
}

// 温度传感器读取回调
int temp_handler(const char *path, const char *query,
                 char *out_buf, int buf_size) {
    int temp = read_temperature();  // 假设有硬件读取函数
    snprintf(out_buf, buf_size,
             "HTTP/1.1 200 OK\r\n"
             "Content-Type: text/plain\r\n\r\n"
             "Temperature: %d°C", temp);
    return 0;
}

6. 组装与启动服务器

最后一步，把上面所有东西组装起来：

int main() {
    // 1. 注册路由
    register_route("/led/on", led_on_handler);
    register_route("/led/off", led_off_handler);
    register_route("/temp", temp_handler);
    
    // 2. 启动服务器（伪代码）
    server_start(8080);  // 监听8080端口
    
    // 3. 事件循环
    while (1) {
        int client_fd = server_accept();  // 接受客户端连接
        char request[1024];
        recv(client_fd, request, sizeof(request), 0);  // 接收HTTP请求
        
        char response[2048];
        dispatch_request(request, response, sizeof(response));  // 分发
        
        send(client_fd, response, strlen(response), 0);  // 发送响应
        close(client_fd);
    }
    
    return 0;
}

你看，整个框架的核心代码加起来不到200行。但它的扩展性非常好——想增加一个新功能？写一个回调函数，注册一下就行了。完全不需要动框架本身的代码。

7. 这个架构的精髓在哪

说白了，这个微型Web服务器框架的精髓，就是「控制反转」。框架控制主循环，你的业务代码通过回调函数被框架调用。你不需要关心Socket怎么收数据、怎么发数据，只需要关心「收到某个请求时，我要干什么」。

我在实际项目中，用这个模式做过：

• 嵌入式设备的Web配置界面
• 智能家居的本地控制中心
• 测试工具中的HTTP Mock服务器

每次都是同样的框架，换不同的回调函数而已。这就是回调机制带来的复用价值。

---

公众号:蓝海资料掘金营，微信deep3321