需要查看完整教程请移步:http://blog.didispace.com/springbootswagger2/
1.不建议使用2.5.2版本以下的swagger2,对有些服务无法兼容支持 ,例:
在controller中使用 注入Feign的方式调用eureka服务时
本人使用的是2.7.0的版本
2. swagger2的配置类
title:为 Swagger ui.html展示的标题
description:为描述详情
termsOfServiceUrl :是一个连接地址
contact:是创建者的详情,包含名称等
version:为版本号
apis:这里配置的是你的完整项目名,不能配置错误,不然无法扫描到正确的控制器加载文档
3.
在控制层接口上添加注解@ApiOpration 说明这个接口的描述有 value 及 notes
若有多个参数的情况下,需用注解@ApiImplicitParams({@ApiImplicitParam(),...})说明参数
@ApiImplicitParam 有 name(入参的名字) , value(入参的描述) , required(约束) ,dataType(数据类型),ParamType(入参获取方式) 目前已知:属性 path ,实体类 body