gRPC Context

最新推荐文章于 2023-10-12 16:21:03 发布

Linkkk丶

最新推荐文章于 2023-10-12 16:21:03 发布

阅读量1.6k

点赞数

分类专栏： gRPC

gRPC 专栏收录该内容

14 篇文章

订阅专栏

本文将深入探讨gRPC Context，特别是ServerContext的使用。通过ServerContext，开发者能够添加自定义元数据，控制调用设置如压缩和权限验证，获取客户端元数据以及进行性能度量。Context设置只对特定的调用handler有效，但部分设置如压缩可以在服务器级别进行全局配置。

摘要由CSDN通过智能技术生成

gRPC Context

ServerContext

ServerContext 或 CallbackServerContext 允许 code 实现一个 service handler 来：

添加自定义初始化和尾部的元数据键值对，并向客户端 side 发送。
控制调用设置例如压缩和权限验证。
访问来自客户端的元数据。
获取性能度量(例如，统计)。

Context 设置仅与被提供的调用handler相关，这就是说，它们不能再多个调用中传递。这些设置中的某些，例如压缩选项，能够在服务器构造上成为永久的设置，通过向grpc::ServerBulider指定一个合适的参数, 参数可以由ServerBuilder::AddChannelArgument添加。

namespace grpc_impl {
class ServerContextBase {
public:
	// 返回服务器调用的deadline
	std::chrono::system_clock::time_point deadline() const;
	
	// 返回在服务器能够提供向客户端他的状态之前，这个RPC是否失败。这可能是由于显式的客户端或服务器 side 		     
	// 的 API取消，由于deadline exceeded，network connection reset，HTTP/2 parameter \
	// configuration(例如，max message size, max connection age) 等。它不包含失败，因为一个 non-OK 	
	// 状态会从服务器应用的request handler返回，包括 Status::CANCELLED。
	
	// 当使用同步或者Callback API时，IsCancelled 总是安全的。当使用异步API时，仅当
	// AsyncNotifyWhenDone 标志已经被传递了，才安全。线程安全。
	bool IsCancelled() const;
	
	
}
} // namespace grpc_impl