通常的文档生成工具，都需要开发人员编写注解或注释，代码入侵太强，而且费事，我希望api工具具有如下功能：

 

1. 自动解析代码，根据代码生成api接口，如果有注释就自动扫描注释(自动集成swagger)，没有就以代码为准，生成的api接口如果有不合理的地方，可以在页面进行修改，利用web页面的表单编辑修改要比在代码里处理方便直观。
2. Api接口调整自动完成维护，自动通知开发测试改动部分内容（集成邮件或极光推送等）。
3. 自动按项目模块结构归(移植对接yapi项目目录结构)，可*调整目录结构。
4. 开发测试api自动集成登录验证，直接输入参数请求调试接口，支持默认数据字典数据填充，前后台都抛弃PostMan等第三方测试工具。
5. Api接口确定后前后端开发分离，自动mock接口数据，开发完成关闭mock进入联调。
6. 工具提供自动化测试，根据测试场景*按接口api组合，设置测试案例集合。生成测试案例报告。

• 内容

系统分两部分

1. Retail-mock ：数据模拟、api服务提供者、api网关。

 

1. retail-mapping ：api接口自动扫描程序。集成到目标项目代码扫描所有controller Postmapping、Getmapping。

 

1. Retail-mock ：库表结构

 

 

• 使用

1.Pom中引入jar包

<dependency>

       <groupId>net.blissmall.retail.mapping</groupId>

       <artifactId>retail-mapping</artifactId>

       <version>0.0.3-SNAPSHOT</version>

   </dependency>

2.application.properties 资源文件中引入

#是否进行api解析

retail.mapping.enable=true

#是否使用mock数据

retail.mock.enable=false

1. 启动类需要添加扫包配置，@SpringBootApplication 默认配置无法扫描解析第三方jar @service标签

@SpringBootApplication(scanBasePackages = {"net.blissmall.retail"})

1. 本地启动mock调试界面 ：http://localhost:8100/index.html

 

说明：请求地址: 可选可配如：dev qa02 localhost 等

Token: 不输入使用系统默认system账号自动登录系统

id: 接口api主键id

参数: 请求参数支持post，get格式