gRPC源码分析(三)：从Github文档了解gRPC的项目细节

时间：2020-10-14 22:58:15 阅读：66 评论：0 收藏：0 [点我收藏+]

gRPC源码分析(三)：从Github文档了解gRPC的项目细节

官方Git总览

我们先看看GRPC这个项目的总览，主要分三种：

基于C实现，包括了 C++, Python, Ruby, Objective-C, PHP, C#
其余语言实现的，最主要是go，java，node
proposal，即grpc的RFC，关于实现、讨论的文档汇总

从这里可以看出，gRPC虽然是支持多语言，但原生的实现并不多。如果想在一些小众语言里引入gRPC，还是有很大风险的，有兴趣的可以搜索下TiDB在探索rust的gRPC的经验分享。

gRPC-Go

作为一名Go语言开发者，我自然选择从最熟悉的语言入手。同时，值得注意的是，grpc-go是除了C家族系列以外使用量最大的repo，加上Go语言优秀的可读性，是一个很好的入门gRPC的阅读材料。

进入项目，整个README.md文档也不长。通常情况下，如果你能啃完这个文档及相关链接，你对这个开源项目就已经超过99%的人了。

对Repo的相关注意事项，大家逐行阅读即可，整体比较简单，我简单列举下关键点：

建议阅读官网文档（恭喜你，上次我们已经读完了官方文档）
在项目中的引入，建议用go mod
优先支持3个Go语言最新发布的版本
FAQ中的常见问题，主要关注package下载问题和如何开启追踪日志

通读完成，我们再深入看看文档细节，Example这块我们在官网的测试中已经看过，我们的接下来重点是godoc和具体细节的文档。

go doc

DefaultBackoffConfig

注意，这个变量被弃用，被挪到 ConnectParams里了(详情链接)。那这个所谓的连接参数是什么用呢？代码不长，我们选择几个比较重要的内容来阅读下，原链接可以点击这里。

// Backoff returns the amount of time to wait before the next retry given the
// number of retries.
// 根据retries返回等待时间，可以认为是一种退避策略
func (bc Exponential) Backoff(retries int) time.Duration {
	if retries == 0 {
    // 之前没有retries过，就返回BaseDelay
		return bc.Config.BaseDelay
	}
	backoff, max := float64(bc.Config.BaseDelay), float64(bc.Config.MaxDelay)
  // 等待时间不能超过max，等待时间 = BaseDelay * Multiplier的retries次方
  // Multiplier默认1.6，并不是官方http包中的2
	for backoff < max && retries > 0 {
		backoff *= bc.Config.Multiplier
		retries--
	}
	if backoff > max {
		backoff = max
	}
	// Randomize backoff delays so that if a cluster of requests start at
	// the same time, they won‘t operate in lockstep.
  // 乘以一个随机因子，数值为(1-Jitter,1+Jitter)，默认为(0.8,1.2)，防止同一时刻有大量请求发出，引起锁的问题
	backoff *= 1 + bc.Config.Jitter*(grpcrand.Float64()*2-1)
	if backoff < 0 {
		return 0
	}
	return time.Duration(backoff)
}