Day 42: std.http模块：HTTP协议

1. 引言

欢迎来到第四十二天！HTTP（超文本传输协议）是现代互联网的基石，支撑着整个Web的运作。昨天我们学习了底层的TCP套接字，而 std.http 模块则是在TCP之上提供了一个更高层次的抽象，专门用于处理HTTP/1.1协议。它为我们封装了复杂的HTTP报文解析和格式化工作，让我们能更专注于业务逻辑，而不是协议细节。今天，我们将学习如何使用 std.http 来创建一个简单的HTTP客户端和服务器。

注意：std.http 模块目前仍在积极开发中，其API在未来的Zig版本中可能会有变动。它目前提供的是一个相对基础的实现，适合学习和简单的应用。

2. HTTP 客户端

std.http.Client 结构体可以帮助我们方便地发起HTTP请求。

const std = @import("std");

pub fn main() !void {
    const allocator = std.heap.page_allocator;
    var client = std.http.Client.init(allocator);
    defer client.deinit();

    // 创建一个请求
    var req = try client.request(.GET, "http://example.com/", .{});
    defer req.deinit();

    // 发送请求并等待响应
    try req.start();
    try req.wait();

    // 处理响应
    if (req.response) |res| {
        std.debug.print("Status: {d}\n", .{res.status});
        var body_reader = res.reader();
        const body = try body_reader.readAllAlloc(allocator, 1 * 1024 * 1024);
        defer allocator.free(body);
        std.debug.print("Body: {s}\n", .{body});
    }
}

客户端的使用流程是：

初始化 Client。
使用 client.request() 创建一个 Request 对象，指定方法（.GET, .POST等）、URL和请求头。
调用 req.start() 开始发送请求。
调用 req.wait() 等待响应完成。
通过 req.response 访问 Response 对象，并读取其状态码、响应头和响应体。

3. HTTP 服务器

std.http.Server 让我们能轻松地创建一个监听HTTP请求的服务器。

const std = @import("std");

pub fn main() !void {
    const allocator = std.heap.page_allocator;
    var server = std.http.Server.init(allocator, .{ .reuse_address = true });
    defer server.deinit();

    try server.listen("127.0.0.1", 8080);
    std.log.info("Listening on http://127.0.0.1:8080", .{});

    while (true) {
        var response = try server.accept();
        defer response.deinit();

        // 处理请求并发送响应
        handleRequest(&response);
    }
}

fn handleRequest(response: *std.http.Server.Response) void {
    // ...
}

服务器的流程是：

初始化 Server。
调用 server.listen() 绑定并监听一个地址和端口。
在一个循环中调用 server.accept()，它会阻塞直到接收到一个新的请求，并返回一个 Server.Response 对象。
通过 Server.Response 对象，你可以访问客户端的请求信息（response.request），并写入你的响应数据。

4. 请求头与响应体

请求头: response.request.headers 是一个 std.http.Headers 对象，你可以用 .get("header-name") 来获取请求头的值。
响应头: 你可以使用 response.headers.append("key", "value") 来添加你自己的响应头。
响应体: 使用 response.writer() 获取一个 Writer，然后像操作文件或标准输出一样写入你的响应内容。

5. 示例：一个简单的REST API端点

让我们实现 handleRequest 函数，创建一个返回JSON的简单API。

fn handleRequest(response: *std.http.Server.Response) !void {
    // 检查请求路径和方法
    if (std.mem.eql(u8, response.request.target, "/api/hello") and response.request.method == .GET) {
        // 设置响应头
        try response.headers.append("Content-Type", "application/json");
        // 设置状态码
        response.status = .ok; // 200

        // 写入JSON响应体
        const body = "{\"message\":\"Hello, Zig!\"}";
        try response.writer().writeAll(body);
        try response.finish(); // 必须调用finish来发送响应
    } else {
        response.status = .not_found; // 404
        try response.finish();
    }
}

6. 实践练习：处理POST请求

修改你的服务器，添加一个处理 /api/submit 的POST请求的端点。

检查请求方法是否是 .POST。
从 response.request.reader() 读取请求体。
将读取到的请求体作为响应，回显给客户端。

7. 常见问题

问：如何处理分块传输编码（Chunked Transfer Encoding）？

答：std.http 模块会自动处理分块编码。当客户端发送一个分块编码的请求体时，response.request.reader() 会自动为你解码，你只需要像读取普通流一样读取它即可。同样，如果你在响应中不设置 Content-Length 头，Server 会自动使用分块编码来发送你的响应体。

问：std.http.Status 枚举包含了哪些状态码？

答：std.http.Status 是一个包含了所有标准HTTP状态码的枚举，例如 .ok (200), .not_found (404), .internal_server_error (500) 等。这使得处理状态码时具有类型安全，避免了使用“魔法数字”。

8. 总结

今天，我们学习了如何使用 std.http 模块来构建HTTP客户端和服务器。我们了解了 Client 和 Server 的基本工作流程，学会了如何处理HTTP请求和响应的头信息与正文。虽然 std.http 仍在发展中，但它已经为在Zig中进行Web开发和API交互提供了一个坚实的基础。通过将复杂的协议细节封装起来，它让我们能更专注于应用程序的逻辑。

明天，我们将探讨Zig中异步编程的基础：std.event模块和事件循环。