基本介绍
注意事项
命令使用
- 手动模式
- 自动模式
  - Goland/Idea
  - Visual Studio Code
具体使用手摸手
常见问题FAQ
- 当logic中的结构体存在嵌套时，无法自动生成嵌套类型的方法
- 快速定位接口的具体实现

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

该功能特性为实验性特性。建议开发者以logic下的模块划分为主，梳理模块间关联关系，避免循环依赖，充分利用Golang编译器的循环依赖检测特性编写更高质量的项目代码。

基本介绍

设计背景

在业务项目实践中，业务逻辑封装往往是最复杂的部分，同时，业务模块之间的依赖十分复杂、边界模糊，较难采用Golang包管理的形式。如何有效管理项目中的业务逻辑封装部分，对于每个采用Golang开发的项目都是必定会遇到的难题。

在标准的软件设计流程中，模块与模块之间的依赖会先明确接口定义，在软件开发的实施过程中再通过代码来具体实现。但在大部分高节奏的互联网工程下，并没有严谨的软件设计流程，甚至开发人员的质量水平也参差不齐，大部分开发人员首先关心的是如何去实现需求场景对应的功能逻辑，尽可能地提高开发效率。

设计目标

提供一种代码管理方式，可以通过具体模块实现直接生成模块接口定义、模块注册代码。
简化业务逻辑实现与接口分离的实现，降低模块方法与接口定义的重复操作，提高模块与模块之间的透明度与调用便捷性。

设计实现

增加logic分类目录，将所有业务逻辑代码迁移到logic分类目录下，采用包管理形式来管理业务模块。
业务模块之间的依赖通过接口化解耦，将原有的service分类调整为接口目录。这样每个业务模块将会各自维护、更加灵活。
可以按照一定的编码规范，从logic业务逻辑代码生成service接口定义代码。同时，也允许人工维护这部分service接口。

注意事项

再次提醒，通过logic实现去生成service接口并不是一个代码管理的标准化做法，只是提供另一个可供选择的、便捷的代码管理方式。这种管理方式有优点也有缺点，优点是针对微服务场景的业务模块的接口自动生成比较方便；缺点是无法识别语法继承关系、无法生成父级嵌套类型的方法、抛弃了Golang编译时检测循环依赖的特性。

框架的工程管理当然也支持标准的接口代码管理方式，即支持先定义service接口，再编码logic具体实现。需要注意的是，这个service的源代码中不能出现顶部工具的注释信息（工具依靠这个注释来判断该文件是否可覆盖😈），很多同学复制粘贴的时候把文件顶部注释保留了，就会引起手动维护接口文件失效。具体见截图注释：

命令使用

该命令通过分析给定的logic业务逻辑模块目录下的代码，自动生成service目录接口代码。

需要注意：

由于该命令是根据业务模块生成service接口，因此只会解析二级目录下的go代码文件，并不会无限递归分析代码文件。以logic目录为例，该命令只会解析logic/xxx/*.go文件。因此，需要logic层代码结构满足一定规范。
不同业务模块中定义的结构体名称在生成的service接口名称时可能会重复覆盖，因此需要在设计业务模块时保证名称不能冲突。

该命令的示例项目请参考：https://github.com/gogf/gf-demo-user

手动模式

如果是手动执行命令行，直接在项目根目录下执行 gf gen service 即可。

$ gf gen service -h
USAGE
    gf gen service [OPTION]
OPTION
    -s, --srcFolder         source folder path to be parsed. default: internal/logic
    -d, --dstFolder         destination folder path storing automatically generated go files. default: internal/service
    -f, --dstFileNameCase   destination file name storing automatically generated go files, cases are as follows:
                            | Case            | Example            |
                            |---------------- |--------------------|
                            | Lower           | anykindofstring    |
                            | Camel           | AnyKindOfString    |
                            | CamelLower      | anyKindOfString    |
                            | Snake           | any_kind_of_string | default
                            | SnakeScreaming  | ANY_KIND_OF_STRING |
                            | SnakeFirstUpper | rgb_code_md5       |
                            | Kebab           | any-kind-of-string |
                            | KebabScreaming  | ANY-KIND-OF-STRING |
    -w, --watchFile         used in file watcher, it re-generates all service go files only if given file is under
                            srcFolder
    -a, --stPattern         regular expression matching struct name for generating service. default: ^s([A-Z]\\w+)$
    -p, --packages          produce go files only for given source packages
    -i, --importPrefix      custom import prefix to calculate import path for generated importing go file of logic
    -l, --clear             delete all generated go files that are not used any further
    -h, --help              more information about this command
EXAMPLE
    gf gen service
    gf gen service -f Snake

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

参数说明：

名称必须默认值含义

srcFolder 是 internal/logic 指向logic代码目录地址

dstFolder 是 internal/service 指向生成的接口文件存放目录

dstFileNameCase 否 Snake 生成的文件名名称格式

stPattern

否

s([A-A]\w+)

使用正则指定业务模块结构体定义格式，便于解析业务接口定义名称。在默认的正则下，所有小写s开头，大写字母随后的结构体都将被当做业务模块接口名称。例如：

logic结构体名称	service接口名称
`sUser`	`User`
`sMetaData`	`MetaData`

watchFile

用在代码文件监听中，代表当前改变的代码文件路径

packages 仅生成指定包名的接口文件，给定字符串数组，通过命令行传参则给定JSON字符串，命令行组件自动转换数据类型

importPrefix 指定生成业务引用文件中的引用包名前缀

overwrite true 生成代码文件时是否覆盖已有文件

clear false 自动删除logic中不存在的接口文件（仅删除自动维护的文件）

自动模式

`Goland/Idea`

如果您是使用的GolandIDE，那么可以使用我们提供的配置文件：watchers.xml 自动监听代码文件修改时自动生成接口文件。使用方式，如下图：

`Visual Studio Code`

如果您是使用的Visual Studio Code，那么可以安装插件 RunOnSave 随后配置插件：

        "emeraldwalk.runonsave": {
            "commands": [
                {
                    "match": ".*logic.*go",
                    "isAsync": true,
                    "cmd": "gf gen service"
                }
            ]
        }