该功能特性从v2.4版本开始提供。

基本介绍

该命令用于编译proto文件，生成对应的protobuf go文件以及对应的控制器文件。

命令使用

  1. $ gf gen pb -h
  2. USAGE
  3.     gf gen pb [OPTION]
  5. OPTION
  6.     -p, --path   protobuf file folder path
  7.     -a, --api    output folder path storing generated go files of api
  8.     -c, --ctrl   output folder path storing generated go files of controller
  9.     -h, --help   more information about this command
  11. EXAMPLE
  12.     gf gen pb
  13.     gf gen pb -p . -a . -p .

如果使用框架推荐的项目工程脚手架，并且系统安装了make工具，也可以使用make pb快捷指令。

参数说明：

名称必须默认值含义
path否manifest/protobuf指向proto协议定义文件
api否api指向生成的接口文件存放目录
ctrl否internal/controller指向生成的控制器文件存放目录

注意事项

  • 在生成控制器文件时，会自动识别是否已经存在对应的接口实现方法，如果已经存在则不再重复生成对应的接口方法，防止覆盖。
  • 如果在proto目录执行该命令，并且指定的path目录不存在时，那么将会自动编译本地proto文件，且编译后的文件生成到当前目录，并自动关闭控制器文件的生成功能。