SAPI V1.4发布,轻巧的API输出测试组件

spring.boot.sapi.starter

一个简单的API输出工具,只需简单配置,便可将接口中的全部API接口及参数所有以结构化的方式输出的页面上。
基于SpringMvc或Springboot的接口管理工具java

1.下载并打包Jar配置好POMgit

<dependency>
  <groupId>com.github.xiaour</groupId>
  <artifactId>xiaour.springboot.sapi.starter</artifactId>
  <version>1.4</version>
</dependency>

2.启动类加入注解@Sapi.
controllers属性能够声明多个,如controllers = {"com.example.demo.ctrl","com.example.demo2.ctrl"},controllers的路径对应项目中controller所在的路径。enable是SAPI的开关,若是须要上生产环境只须要enable=false就能够了,这样避免在生产暴露接口。github

@Sapi(controllers = {"com.example.demo.ctrl"})
@SpringBootApplication
public class DemoApplication {

   public static void main(String[] args) {
      SpringApplication.run(DemoApplication.class, args);
   }
}

3.Controller类加入注解@SapiGroup(title="").
SapiGroup是用于分组输出的注解,能够在上面加入中文接口注释,该注解无关紧要,如不注解,默认输出的是当前类名。spring

@SapiGroup(title = "小猫管理")
@RestController
@RequestMapping("/cat")
public class CatController {
    
}

4.项目启动后会在控制台输出一条SAPI的URL,打开就能够看到相关的API了,下面是一个打开后的演示界面。快快测试你的API吧!api

avatar

目前项目在Github和码云都有开源,欢迎Star或fork
https://github.com/xiaour/spr...
https://gitee.com/xiaour/spri...springboot

版本功能

当前为1.4版本,实现了输出接口URL和参数,分组输出接口;app

2.0版本将实现添加接口说明、历史版本接口管理

更新日志工具

20180621.页面上提供了POST和GET测试。测试

20180628.新增支持文件类型的数据。优化

20180702.新增支持自定义请求Header。

20180710.新增了接口分页。

20180828.优化了返回结果格式化的问题。

20180907.改版了界面列表展现部分,修复了Class扫描不到的状况。

20180912.增长了对RequestBody的支持,支持MultipartFile上传文件。

相关文章
相关标签/搜索