告别Swagger3/Apifox/Postman
Swagger3(丝袜哥)
- 地址:REST API Documentation Tool | Swagger UI
- 简介:在java代码里面增加注解生成接口文档
-
-
在代码里面增加注解
RestController
@RequestMapping("api/v1/user")
@Api(tags = "用户模块",value = "用户UserController")
public class UserController {
@Autowired
private BannerService bannerService;
@ApiOperation("分页用户列表")
@GetMapping("list")
public JsonData list(){
List<BannerDO> list = bannerService.list();
return JsonData.buildSuccess(list);
}
}
-
-
优点
-
- 支持SpringMVC、SpringBoot、SpringCloud等主流java框架
- 对java代码友好
- 界面简洁
- 国内比较活跃,主要是spring社区带动
- 功能比较多
- 缺点
-
- 对跨语言支持不友好(可以和knife4j整合解决这个问题)
- 代码需要引入相关依赖包和配置
- 文档相对缺少
Apifox(智灵狐)
-
- Apifox = Postman + Swagger + Mock + JMeter
- 设计、开发、测试一体化协作平台
PostMan(邮寄男人)
- 地址:Download Postman | Get Started for Free
- 简介:用来模拟各种HTTP请求的(如:get/post/delete/put...等等),postman与浏览器的区别在于有的浏览器不能输出json格式,而postman可以更直观看到接口返回的结果。
试试IDEA自带的 Generate request in HTTP Client
工具使用:
官方模板:
写操作Post/Delete/Put:
###
POST http://localhost:24618/user/add
Accept: application/json
Content-Type: application/json
{
"username": "zhangsan",
"password": "123456",
"sex": "1"
}
读操作Get:
###
GET http://localhost:24618/user/{{id}}
//将上述{{id}}换成一个真实的主键id即可