goctl rpc

概述

goctl rpc 是 goctl 中的核心模块之一，其可以通过 .proto 文件一键快速生成一个 rpc 服务，如果仅仅是启动一个 go-zero 的 rpc 演示项目， 你甚至都不用编码，就可以完成一个 rpc 服务开发及正常运行。在传统的 rpc 项目中，我们要创建各级目录，编写结构体， 定义路由，添加 logic 文件，这一系列操作，如果按照一条协议的业务需求计算，整个编码下来大概需要 5 ～ 6 分钟才能真正进入业务逻辑的编写， 这还不考虑编写过程中可能产生的各种错误，而随着服务的增多，随着协议的增多，这部分准备工作的时间将成正比上升， 而 goctl rpc 则可以完全替代你去做这一部分工作，不管你的协议要定多少个，最终来说，只需要花费 10 秒不到即可完成。

goctl rpc 指令

  1. $ goctl rpc --help
  2. Generate rpc code
  4. Usage:
  5.   goctl rpc [flags]
  6.   goctl rpc [command]
  8. Available Commands:
  9.   new         Generate rpc demo service
  10.   protoc      Generate grpc code
  11.   template    Generate proto template
  13. Flags:
  14.       --branch string   The branch of the remote repo, it does work with --remote
  15.   -h, --help            help for rpc
  16.       --home string     The goctl home path of the template, --home and --remote cannot be set at the same time, if they are, --remote has higher priority
  17.       --o string        Output a sample proto file
  18.       --remote string   The remote git repo of the template, --home and --remote cannot be set at the same time, if they are, --remote has higher priority
  19.                             The git repo directory must be consistent with the https://github.com/zeromicro/go-zero-template directory structure
  22. Use "goctl rpc [command] --help" for more information about a command.
goctl rpc - 图1 参数字段goctl rpc - 图2 参数类型goctl rpc - 图3 是否必填goctl rpc - 图4 默认值goctl rpc - 图5 参数说明
branchstringNO空字符串模板仓库分支，配合 —remote 使用
homestringNO~/.goctl模板仓库本地路径，优先级高于 —remote
ostringNO空字符串输出 api 文件
remotestringNO空字符串模板仓库远程路径

示例：生成 proto 文件

  1. $ goctl rpc --o greet.proto

goctl rpc new

快速生成一个 rpc 服务，其接收一个终端参数来指定服务名称。

  1. $ goctl rpc new --help
  2. Generate rpc demo service
  4. Usage:
  5.   goctl rpc new [flags]
  7. Flags:
  8.       --branch string   The branch of the remote repo, it does work with --remote
  9.   -h, --help            help for new
  10.       --home string     The goctl home path of the template, --home and --remote cannot be set at the same time, if they are, --remote has higher priority
  11.       --idea            Whether the command execution environment is from idea plugin.
  12.       --remote string   The remote git repo of the template, --home and --remote cannot be set at the same time, if they are, --remote has higher priority
  13.                             The git repo directory must be consistent with the https://github.com/zeromicro/go-zero-template directory structure
  14.       --style string    The file naming format, see [https://github.com/zeromicro/go-zero/tree/master/tools/goctl/config/readme.md] (default "gozero")
  15.   -v, --verbose         Enable log output
goctl rpc - 图6 参数字段goctl rpc - 图7 参数类型goctl rpc - 图8 是否必填goctl rpc - 图9 默认值goctl rpc - 图10 参数说明
branchstringNO空字符串模板仓库分支，配合 —remote 使用
homestringNO~/.goctl模板仓库本地路径，优先级高于 —remote
ideaboolNOfalse仅 idea 插件用，终端请忽略此字段
remotestringNO空字符串模板仓库远程路径
stylestringNOgozero文件命名风格，详情可参考 文件风格

示例：

  1. $ goctl rpc new greet

goctl rpc protoc

根据 protobufer 文件生成 rpc 服务。

  1. $ goctl rpc protoc --help
  2. Generate grpc code
  4. Usage:
  5.   goctl rpc protoc [flags]
  7. Examples:
  8. goctl rpc protoc xx.proto --go_out=./pb --go-grpc_out=./pb --zrpc_out=.
  10. Flags:
  11.       --branch string     The branch of the remote repo, it does work with --remote
  12.   -h, --help              help for protoc
  13.       --home string       The goctl home path of the template, --home and --remote cannot be set at the same time, if they are, --remote has higher priority
  14.   -m, --multiple          Generated in multiple rpc service mode
  15.       --remote string     The remote git repo of the template, --home and --remote cannot be set at the same time, if they are, --remote has higher priority
  16.                             The git repo directory must be consistent with the https://github.com/zeromicro/go-zero-template directory structure
  17.       --style string      The file naming format, see [https://github.com/zeromicro/go-zero/tree/master/tools/goctl/config/readme.md] (default "gozero")
  18.   -v, --verbose           Enable log output
  19.       --zrpc_out string   The zrpc output directory
goctl rpc - 图11 参数字段goctl rpc - 图12 参数类型goctl rpc - 图13 是否必填goctl rpc - 图14 默认值goctl rpc - 图15 参数说明
branchstringNO空字符串模板仓库分支，配合 —remote 使用
homestringNO~/.goctl模板仓库本地路径，优先级高于 —remote
multipleboolNOfalse是否生成多个 rpc 服务
remotestringNO空字符串模板仓库远程路径
stylestringNOgozero文件命名风格，详情可参考 文件风格
zrpc_outstringNO空字符串输出目录

除了上述参数外，还有支持 protoc 指令的原生参数，详情可参考 Go Generated Code Guide。

示例：

  1. # 单个 rpc 服务生成示例指令
  2. $ goctl rpc protoc greet.proto --go_out=./pb --go-grpc_out=./pb --zrpc_out=.
  3. # 多个 rpc 服务生成示例指令
  4. $ goctl rpc protoc greet.proto --go_out=./pb --go-grpc_out=./pb --zrpc_out=. -m
goctl rpc - 图16tip

多个 rpc 服务生成示例（rpc 分组）生成效果可参考 服务分组

goctl rpc - 图17小技能

goctl rpc protoc 指令比较长，参数很多，其实在理解 protoc 用法的前提下，你可以将指令理解成是如下的形式：

goctl rpc ${protoc 用法} —zrpc_out=${output directory}，比如指令 goctl rpc protoc greet.proto --go_out=./pb --go-grpc_out=./pb --zrpc_out=.，其中 protoc greet.proto --go_out=./pb --go-grpc_out=./pb 完全是 protoc 指令的用法，而 --zrpc_out=. 则是 goctl rpc protoc 指令的的参数。

goctl rpc - 图18注意

goctl rpc protoc 指令生成 rpc 服务对 proto 有一些事项须知：

  1. proto 文件中如果有 import 语句，goctl 不会对 import 的 proto 文件进行处理，需要自行手动处理。
  2. rpc service 中的请求体和响应体必须是当前 proto 文件中的 message，不能是 import 的 proto 文件中的 message。

goctl rpc template

快速生成一个 proto 模板文件，其接收一个 proto 文件名称参数。

goctl rpc - 图19注意

该指令已经废弃，推荐使用 goctl rpc -o 指令。

  1. $ goctl rpc template --help
  2. Generate proto template
  4. Usage:
  5.   goctl rpc template [flags]
  7. Flags:
  8.       --branch string   The branch of the remote repo, it does work with --remote
  9.   -h, --help            help for template
  10.       --home string     The goctl home path of the template, --home and --remote cannot be set at the same time, if they are, --remote has higher priority
  11.       --o string        Output a sample proto file
  12.       --remote string   The remote git repo of the template, --home and --remote cannot be set at the same time, if they are, --remote has higher priority
  13.                             The git repo directory must be consistent with the https://github.com/zeromicro/go-zero-template directory structure
goctl rpc - 图20 参数字段goctl rpc - 图21 参数类型goctl rpc - 图22 是否必填goctl rpc - 图23 默认值goctl rpc - 图24 参数说明
branchstringNO空字符串模板仓库分支，配合 —remote 使用
homestringNO~/.goctl模板仓库本地路径，优先级高于 —remote
ostringNO空字符串输出文件路径
remotestringNO空字符串模板仓库远程路径

示例：

  1. $ goctl rpc template -o greet.proto

参考文献