go grpc入门

为什么还要写入门文章，因为按照网上教的，过程还是有问题，一方面是protobuf升级了，一方面是自己电脑go的环境配置不同，所以还是记录一下。

1. 先下载protobuf
   https://github.com/protocolbuffers/protobuf/releases/tag/v3.15.8
   我是win10, 下载的是protoc-3.15.8-win64
   解压，把bin目录加入Path环境变量
2. 检查自己的go环境变量，比如GOPATH是哪个目录，有没有开启GO111MODULE
   完整的环境变量可以执行go env查看
   因为这个影响go get 下载的包是放到src还是pkg；
   比如，我的GOPATH配的是/e/go_workspace/demo
GO111MODULE = on
   那么，go get 下载的包会到 /e/go_workspace/demo/pkg/mod 目录里
   开启GO111MODULE后Goland IDE也要设置一下，不然会提示引入包错误（但运行是没问题的）
   
   image.png

GOPROXY=https://goproxy.cn,direct

还要配置GOPROXY环境变量，不然会因为网络问题下载不了包
我的是 https://goproxy.cn

3. 如果你还没有新建过go模块
   先按照这个建一个module，https://golang.google.cn/doc/code
   按go的规则，module可以认为是一个项目
4. 安装两个库

go install google.golang.org/protobuf/cmd/protoc-gen-go
go install google.golang.org/grpc/cmd/protoc-gen-go-grpc

5. 看下$GOPATH/bin目录有没有这两个可执行文件了
   我使用的命令窗口是git bash而不是dos，所以会看到有linux的命令

xhs@DESKTOP-9T60LM4 MINGW64 /e/go_workspace/demo/bin
$ ls
protoc-gen-go-grpc.exe* 
protoc-gen-go.exe*

6. 新建proto文件
   我的模块目录

xhs@DESKTOP-9T60LM4 MINGW64 /e/go_workspace/demo/src/xiaohuasheng.cc/user/hello
$ ls
go.mod  go.sum  grpc/  hello.go  morestrings/

需要关注go.mod，这是这个模块（项目）的信息，它的路径，它依赖哪些包
在grpc目录生成和编写grpc的代码
grpc的demo分三块，接口规范，服务器端的实现，客户端调用，对应的目录是HelloService, server, client

xhs@DESKTOP-9T60LM4 MINGW64 /e/go_workspace/demo/src/xiaohuasheng.cc/user/hello/grpc (master)
$ ls
client/  HelloService/  server/

7. 编写proto文件
   代码我都会放到仓库，见文章最后，这里只提一个我遇到的问题点，proto文件里，要保证go_package的值带有/，不然执行这个命令protoc --go_out=. hello.proto会报错
   看下hello.proto内容

syntax = "proto3";

option go_package = "./;HelloService";

message String {
  string value = 1;
}

service HelloService {
  rpc Hello (String) returns (String);
  rpc Channel (stream String) returns (stream String);
}

当然，执行生成代码命令时记得进入proto文件所在目录，比如

cd /e/go_workspace/demo/src/xiaohuasheng.cc/user/hello/grpc/HelloService 
$ ls
hello.pb.go  hello.proto  hello_grpc.pb.go

执行，生成grpc的代码

protoc --go_out=. hello.proto
protoc --go-grpc_out=. hello.proto

会得到两个文件，不能修改

$ ls
hello.pb.go  hello_grpc.pb.go

8. 编写服务端代码
   有一个点要注意，创建结构体去实现接口的时候，要继承类UnimplementedHelloServiceServer
   这是之前的版本没有的，在这里我也花了一些时间

type HelloServiceImpl struct {
    hs.UnimplementedHelloServiceServer
}

9. 编写客户端代码
   比较简单，直接看代码就好
10. 参考文章
    https://www.cnblogs.com/hongjijun/p/13724738.html
11. 完整的代码
    https://gitee.com/xiaohuasheng/go-hello