协议编译-gen pb

协议编译-gen pb - 图1 提示

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

基本介绍

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

命令使用

$ gf gen pb -h
USAGE
    gf gen pb [OPTION]

OPTION
    -p, --path   protobuf file folder path
    -a, --api    output folder path storing generated go files of api
    -c, --ctrl   output folder path storing generated go files of controller
    -h, --help   more information about this command

EXAMPLE
    gf gen pb
    gf gen pb -p . -a . -p .

协议编译-gen pb - 图2 提示

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

参数说明:

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

注意事项

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