为什么还要写入门文章,因为按照网上教的,过程还是有问题,一方面是protobuf升级了,一方面是自己电脑go的环境配置不同,所以还是记录一下。
- 先下载protobuf
https://github.com/protocolbuffers/protobuf/releases/tag/v3.15.8
我是win10, 下载的是protoc-3.15.8-win64
解压,把bin目录加入Path环境变量 - 检查自己的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也要设置一下,不然会提示引入包错误(但运行是没问题的)
GOPROXY=https://goproxy.cn,direct
还要配置GOPROXY
环境变量,不然会因为网络问题下载不了包
我的是 https://goproxy.cn
- 如果你还没有新建过go模块
先按照这个建一个module,https://golang.google.cn/doc/code
按go的规则,module可以认为是一个项目 - 安装两个库
go install google.golang.org/protobuf/cmd/protoc-gen-go
go install google.golang.org/grpc/cmd/protoc-gen-go-grpc
- 看下
$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*
- 新建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/
- 编写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
- 编写服务端代码
有一个点要注意,创建结构体去实现接口的时候,要继承类UnimplementedHelloServiceServer
这是之前的版本没有的,在这里我也花了一些时间
type HelloServiceImpl struct {
hs.UnimplementedHelloServiceServer
}
- 编写客户端代码
比较简单,直接看代码就好 - 参考文章
https://www.cnblogs.com/hongjijun/p/13724738.html - 完整的代码
https://gitee.com/xiaohuasheng/go-hello