gRPC

gRPC协议支持（基于HTTP/2） 更多...

类
struct	neforce::http::grpc_message
	gRPC 消息帧 更多...
class	neforce::http::grpc_framer
	gRPC消息帧编解码器 更多...
class	neforce::http::grpc_handler
	gRPC服务处理器基类 更多...

枚举
enum class	neforce::http::grpc_status : uint8_t
	gRPC 状态码

详细描述

gRPC协议支持（基于HTTP/2）

gRPC over HTTP/2 协议栈：

• Content-Type: application/grpc[+proto]
• 消息帧格式: [压缩标志(1字节)] [长度(4字节BE)] [消息体]
• 响应尾部: grpc-status, grpc-message

遵循的国际标准

本实现严格遵循以下 gRPC 协议规范与相关标准：

gRPC 协议核心：

• **gRPC over HTTP/2**：gRPC 协议规范（基于 HTTP/2 传输） https://github.com/grpc/grpc/blob/master/doc/PROTOCOL-HTTP2.md
• **gRPC Health Checking Protocol**：gRPC 健康检查协议 https://github.com/grpc/grpc/blob/master/doc/health-checking.md
• **Protocol Buffers**：结构化数据序列化格式 https://protobuf.dev/

底层 HTTP/2 传输：

• **IETF RFC 7540**：HTTP/2（帧层、流、连接管理） https://www.rfc-editor.org/rfc/rfc7540.html
• **IETF RFC 7541**：HPACK（HTTP/2 头部压缩算法） https://www.rfc-editor.org/rfc/rfc7541.html

gRPC 状态码说明

根据 gRPC 协议规范，gRPC 状态码用于表示 RPC 调用的结果：

类别	状态码	含义
OK	0	调用成功
客户端	1-9 (CANCELLED → NOT_FOUND)	请求无效或不符合预期
系统	10-15 (ABORTED → DATA_LOSS)	服务端内部处理失败
认证	16 (UNAUTHENTICATED)	缺少有效认证凭据