Swagger-使用介绍

介绍

使用 swagger 只要按照规范去定义接口及接口相关信息,就可以生成接口文档,以及在线接口调试界面。
官网: https://swagger.io/

直接使用较为麻烦,可以使用 Knife4j 框架,是为 Java MVC框架集成 Swagger 生成 API 文档的增强解决方案。

使用方式

导入 Knife4f 的 maven 坐标

在配置类中加入 knife4f 的相关配置

设置静态资源映射,否则接口文档无法访问

常用注解

@Api

用在类上,表示对类的说明

@ApiModel

也是用在类上,例如 Entity,DTO,VO

@ApiModelProperty

用在属性上,描述属性信息

@ApiOperation

用在方法上,说明方法的用途、作用

你可能感兴趣的:(java)