http://localhost:9999/swagger/order.swagger.json 访问这个接口,实际上是请求到了 ***order.swagger.json***文件的具体内容,此处的处理逻辑是 svrSwaggerFile 函数会将 ***swagger.json过滤出来,并加上相对路径./protoc/order/,实际上就访问到了我们服务项目目录中的my_grpcgateway/protoc/order/order.swagger.j...
不同之处在于增加了swagger的配置,这个配置的作用是让swagger把远程调用配置成http,如果没有这些配置,swagger默认的远程调用就是https的,而grpc-gateway-practice示例工程使用的是http,所以要加上这些配置,在上述message.proto的内容中,具体的配置有以下两处:
在gRPC-Gateway集成swagger服务的过程并不简单,咱们将其中的重点提前看一下,做到心里有数: 为了简化实战过程,gRPC-Gateway暴露的服务并未使用https,而是http,但是swagger-ui提供的调用服务却是https的,因此要在proto文件中指定swagger以http调用服务,指定的时候会用到文件protoc-gen-swagger/options/annotations.proto,因此...
第二,下载 go-bindata-assetfs,用处是 go-bindata-assetfs 能够结合net/http标准库和go-bindata所生成Swagger UI的Go代码两者来供外部访问 ,也就是说 go-bindata-assetfs 可以对外提供文件服务,这样可以通过web访问swagger的json文件 go get -u github.com/elazarl/go-bindata-assetfs/... 在my_grpcgatew...
这个目录是通过工具生成的,主要是处理 swagger 的 go 文件 my_grpcgateway/protoc/order/order.swagger.json 工具生成的 swagger.json 文件,里面记录了关于 swagger 的接口 和 配置相关信息 my_grpcgateway/protoc/order/protoc-gen-swagger protoc-gen-swagger 工具目录 ...
gRPC-GateWay Swagger 实战 基本环境补充 首先,我们来看一下环境搭建完毕和完成实战之后的目录结构 通过目录结构我们可以看到: my_grpcgateway 目录下多了 pkg 目录 这个目录是通过工具生成的,主要是处理 swagger 的 go 文件 my_grpcgateway/protoc/order/order.swagger.json ...
1、概述 Swagger是全球最大的OpenAPI规范(OAS)API开发工具框架,支持从设计和文档到测试和部署的整个API生命周期的开发。Swagger是目前最受欢迎的RESTful Api文档生成工具之一,主要的原因如下: 跨平台、跨语言的支持 强大的社区 生态圈 Swagger Tools(S
gRPC-GateWay Swagger 实战 基本环境补充 首先,我们来看一下环境搭建完毕和完成实战之后的目录结构 通过目录结构我们可以看到: my_grpcgateway 目录下多了 pkg 目录 这个目录是通过工具生成的,主要是处理 swagger 的 go 文件 my_grpcgateway/protoc/order/order.swagger.json ...
gRPC-GateWay Swagger 实战 基本环境补充 首先,我们来看一下环境搭建完毕和完成实战之后的目录结构 通过目录结构我们可以看到: my_grpcgateway 目录下多了 pkg 目录 这个目录是通过工具生成的,主要是处理 swagger 的 go 文件 my_grpcgateway/protoc/order/order.swagger.json 工具生成的 swagger.json 文件,里面记录了...
生成swagger所需的json文件; 下载swagger-ui的源码,以此生成go源码; 编写gRPC的服务端代码; 编写gRPC-Gateway服务端的代码; 验证; 注意,本文的所有操作都没有用到root账号,而是前文创建的golang账号; 源码下载 本篇实战中的源码可在GitHub下载到,地址和链接信息如下...