Boost.Beast HTTP 使用示例详解

俞纬鉴Joshua

于 2025-06-09 09:04:11 发布

阅读量289

点赞数 4

本文链接：https://blog.csdn.net/gitblog_00914/article/details/148524352

版权

Boost.Beast HTTP 使用示例详解

beast HTTP and WebSocket built on Boost.Asio in C++11 项目地址: https://gitcode.com/gh_mirrors/be/beast

Boost.Beast 是一个基于 Boost 的 C++ 网络库，提供了对 HTTP/1 和 WebSocket 协议的低级访问接口。本文将通过几个典型示例，深入讲解如何使用 Boost.Beast 处理 HTTP 协议中的各种场景。

延迟确定消息体类型

在实际开发中，服务器可能需要根据请求头信息动态决定消息体类型。Boost.Beast 提供了灵活的方式来实现这一需求：

首先使用 empty_body 类型解析请求头
根据解析出的请求方法等信息决定最终的消息体类型
基于已有解析器创建新的解析器

// 示例代码框架
request_parser<empty_body> header_parser;
// 读取请求头
read_header(socket, buffer, header_parser);

auto& req = header_parser.get();
if(req.method() == verb::get) {
    // 对GET请求使用string_body
    request_parser<string_body> body_parser(std::move(header_parser));
    // 继续读取消息体
    read(socket, buffer, body_parser);
} else {
    // 其他请求使用其他body类型
}

这种方法特别适用于需要根据请求方法、路径或查询参数动态处理请求体的场景。

处理100-Continue机制

HTTP协议中的100-Continue机制允许客户端在发送大请求体前先确认服务器是否愿意接收该请求。

客户端实现

客户端需要分三步操作：

先发送包含Expect: 100-continue的请求头
等待服务器响应
根据响应决定是否发送请求体

// 创建请求
request<string_body> req{verb::post, "/", 11};
req.set(field::expect, "100-continue");

// 先序列化并发送请求头
request_serializer<string_body> sr{req};
write_header(socket, sr);

// 读取服务器响应
response<string_body> res;
read(socket, buffer, res);

// 检查是否为100 Continue
if(res.result() == status::continue_) {
    // 继续发送请求体
    write(socket, sr);
}

服务器实现

服务器端处理100-Continue请求：

先读取请求头
检查Expect头
发送100 Continue响应
继续读取请求体

// 读取请求头
request_parser<empty_body> parser;
read_header(socket, buffer, parser);

// 检查Expect头
if(parser.get()[field::expect] == "100-continue") {
    // 发送100 Continue响应
    response<empty_body> res{status::continue_, parser.get().version()};
    write(socket, res);
}

// 继续读取请求体
request_parser<string_body> body_parser(std::move(parser));
read(socket, buffer, body_parser);

HEAD请求处理

HEAD方法与GET类似，但不返回消息体，只返回响应头。

客户端处理

客户端需要明确告知解析器不要期待消息体：

// 创建HEAD请求
request<empty_body> req{verb::head, "/", 11};

// 发送请求
write(socket, req);

// 读取响应
response<string_body> res;
res.body().clear();  // 确保body为空

// 关键：告诉解析器跳过body
parser.skip(true);
read(socket, buffer, res);

服务器处理

服务器对HEAD请求的响应应与GET请求相同，但不包含消息体：

// 处理HEAD请求
if(req.method() == verb::head) {
    response<empty_body> res{status::ok, req.version()};
    // 设置与GET相同的头
    res.set(field::server, "Beast");
    res.set(field::content_type, "text/html");
    res.content_length(1234);  // 设置本应返回的内容长度
    write(socket, res);
}

HTTP中继实现

HTTP中继(代理)需要在客户端和服务器之间转发请求和响应。Boost.Beast提供了高效实现方式：

// 从客户端读取请求
request_parser<buffer_body> req_parser;
read_header(client_socket, buffer, req_parser);

// 转发请求到服务器
request_serializer<buffer_body> req_serializer{req_parser.get()};
write_header(server_socket, req_serializer);

// 中继消息体(分块传输)
while(!req_parser.is_done()) {
    // 设置buffer_body的缓冲区
    req_parser.get().body().data = buffer.data();
    req_parser.get().body().size = buffer.size();
    
    // 读取客户端数据
    read(client_socket, buffer, req_parser);
    
    // 转发到服务器
    write(server_socket, req_serializer);
}

这种实现避免了缓冲整个消息体，提高了转发效率。

发送子进程输出

当需要发送非连续内存数据时(如子进程输出)，可以使用buffer_body：

// 创建响应
response<buffer_body> res;
res.result(status::ok);
res.set(field::server, "Beast");
res.set(field::content_type, "text/plain");

// 序列化响应
response_serializer<buffer_body> sr{res};

// 先发送响应头
write_header(socket, sr);

// 从子进程读取并发送数据
char buf[4096];
while(process.read(buf, sizeof(buf))) {
    // 设置buffer_body
    res.body().data = buf;
    res.body().size = bytes_read;
    
    // 发送数据块
    write(socket, sr);
}

这种方法特别适合处理大文件或流式数据，无需缓冲全部内容。