前言
我们通常把RPC用作内部通信，而使用Restful Api进行外部通信。为了避免写两套应用，我们使用grpc-gateway把gRPC转成HTTP。服务接收到HTTP请求后，grpc-gateway把它转成gRPC进行处理，然后以JSON形式返回数据。本篇代码以上篇为基础，最终转成的Restful Api支持bearer token验证、数据验证，并添加swagger文档。
gRPC转成HTTP
编写和编译proto
1.编写simple.proto
可以看到，proto变化不大，只是添加了API的路由路径
2.编译simple.proto
simple.proto文件引用了google/api/annotations.proto，先要把它编译了。我这里是把google/文件夹直接复制到项目中的proto/目录中进行编译。发现annotations.proto引用了google/api/http.proto，那把它也编译了。
进入annotations.proto所在目录，编译：
进入simple.proto所在目录，编译：
以上完成proto编译，接着修改服务端代码。
服务端代码修改
1.server/文件夹下新建gateway/目录，然后在里面新建gateway.go文件
它主要作用是把不用的请求重定向到指定的服务处理，从而实现把HTTP请求转到gRPC服务。
2.gRPC支持HTTP
使用postman测试
在动图中可以看到，我们的gRPC服务已经同时支持RPC和HTTP请求了，而且API接口支持bearer token验证和数据验证。为了方便对接，我们把API接口生成swagger文档。
生成swagger文档
simple.swagger.json
1.安装protoc-gen-swagger
2.编译生成simple.swagger.json
到simple.proto文件目录下，编译：
再次提一下，本人在VSCode中使用VSCode-proto3插件，第一篇有介绍，只要保存，就会自动编译，很方便，无需记忆指令。完整配置如下：
编译生成后把需要的文件留下，不需要的删掉。
把swagger-ui转成Go代码，备用
1.下载swagger-ui
下载地址，把dist目录下的所有文件拷贝我们项目的server/swagger/swagger-ui/目录下。
2.把Swagger UI转换为Go代码
安装go-bindata：
回到server/所在目录，运行指令把Swagger UI转成Go代码。
这步有坑，必须要回到main函数所在的目录运行指令，因为生成的Go代码中的_bindata 映射了swagger-ui的路径，程序是根据这些路径来找页面的。如果没有在main函数所在的目录运行指令，则生成的路径不对，会报404，无法找到页面。本项目server/端的main函数在server.go中，所以在server/所在目录下运行指令。
对外提供swagger-ui
1.在swagger/目录下新建swagger.go文件
2.注册swagger
在gateway.go中添加如下代码
到这里我们已经完成了swagger文档的添加工作了，由于谷歌浏览器不能使用自己制作的TLS证书，所以我们用火狐浏览器进行测试。
用火狐浏览器打开：https://127.0.0.1:8000/swagger-ui/
在最上面地址栏输入：https://127.0.0.1:8000/swagger/simple.swagger.json
然后就可以看到swagger生成的API文档了。
还有个问题，我们使用了bearer token进行接口验证的，怎么把bearer token也添加到swagger中呢？
最后我在grpc-gatewayGitHub上的这个Issues找到解决办法。
在swagger中配置bearer token
1.修改simple.proto文件
2.重新编译生成simple.swagger.json
大功告成！
验证测试
1.添加bearer token
2.调用接口，正确返回数据
3.传递不合规则的数据，返回违反数据验证逻辑错误
总结
本篇介绍了如何使用grpc-gateway让gRPC同时支持HTTP，最终转成的Restful Api支持bearer token验证、数据验证。同时生成swagger文档，方便API接口对接。
教程源码地址：https://github.com/Bingjian-Zhu/go-grpc-example
参考文档
https://www.uoften.com/article/251828.htm
https://www.uoften.com/article/251837.htm