优点:
-
接口的文档可以在线自动生成,降低后端开发人员编写接口文档的负担
-
小巧,轻量
一、快速开始(Spring Boot 2 + OpenAPI2)
Knife4j · 集Swagger2及OpenAPI3为一体的增强解决方案. | Knife4j
二、Swagger常用注解
@Api:对整个类的命名。如员工相关接口。
@ApiOperation:命名某个类的方法,或者说一个接口。如员工登录方法,分页查询方法。
@ApiModel:命名整个对象。如登录时传递的对象。
@ApiModelProperty:命名属性。如登录名,登录密码。