该功能特性从v2.5版本开始提供。该命令目前仅支持HTTP接口开发，GRPC部分请参考gen pb命令。未来会考虑HTTP及GRPC统一使用该命令生成控制器及SDK源代码。

基本介绍

解决痛点

在开发项目的时候，往往需要先根据业务需求和场景设计API接口，使用proto或者golang struct来设计API的输入和输出，随后再创建与API相对应的控制器实现，最后也有可能会提供SDK（同为Golang语言条件下）供内/外部服务调用。在开发过程中会遇到以下痛点：

重复的代码工作较多。在API中创建输入输出定义文件后还需要在控制器目录下创建对应的文件、创建对应的控制器初始化代码、从API代码中反复拷贝各个输入输出结构名称，在这过程重复的操作比较多。
API与控制器之间的关联没有可靠规范约束。除了API有一定的命名约束外，控制器的创建和方法命名并没有约束，灵活度较高，API的结构名称与控制器方法名称难以约束对应，当接口越来越多时会有一定维护成本。
缺少API的HTTP SDK自动生成工具。当开发完API后，往往需要立即给内部或者外部调用，缺少便捷的SDK生成，需要手动来维护这部分SDK代码，那么对于调用端来说成本非常高。

命令特性

规范关联API定义与控制器文件命名、控制器实现方法命名。
根据API定义自动生成控制器接口、控制器初始化文件及代码、接口初始化代码。
根据API定义自动生成易于使用的HTTP SDK代码。
支持自动化生成模式：当某个API结构定义文件发生变化时，自动增量化更新对应的控制器、SDK代码。

命令使用

该命令通过分析给定的api接口定义目录下的代码，自动生成对应的控制器/SDK Go代码文件。

手动模式

如果是手动执行命令行，直接在项目根目录下执行 gf gen ctrl 即可，她将完整扫描api接口定义目录，并生成对应代码。

$ gf gen ctrl -h
USAGE
    gf gen ctrl [OPTION]
OPTION
    -s, --srcFolder       source folder path to be parsed. default: api
    -d, --dstFolder       destination folder path storing automatically generated go files. default: internal/controller
    -w, --watchFile       used in file watcher, it re-generates go files only if given file is under srcFolder
    -k, --sdkPath         also generate SDK go files for api definitions to specified directory
    -v, --sdkStdVersion   use standard version prefix for generated sdk request path
    -n, --sdkNoV1         do not add version suffix for interface module name if version is v1
    -h, --help            more information about this command
EXAMPLE
    gf gen ctrl

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

参数说明：

名称	必须	默认值	含义
`srcFolder`	否	`api`	指向`api`接口定义文件目录地址
`dstFolder`	否	`internal/controller`	指向生成的控制器文件存放目录
`watchFile`	否		用在IDE的文件监控中，用于根据当文件发生变化时自动执行生成操作
`sdkPath`	否		如果需要生成`HTTP SDK`，该参数用于指定生成的SDK代码目录存放路径
`sdkStdVersion`	否		生成的`HTTP SDK`是否使用标准的版本管理。标准的版本管理将自动根据`API`版本增加请求的路由前缀。例如`v1`版本的API将会自动增加`/api/v1`的请求路由前缀。
`sdksdkNoV1`	否		生成的`HTTP SDK`中，当接口为`v1`版本时，接口模块名称是否不带`V1`后缀。