即启动启动类
出现以下错误
Unable to infer base url. This is common when using dynamic servlet registration or when the API is behind an API Gateway. The base url is the root of where all the swagger resources are served. For e.g. if the api is available at http://example.org/api/v2/api-docs then the base url is http://example.org/api/. Please enter the location manually:
问题出在,对于swagger的版本过老,之前做项目时候用的2.0的,在解决问题的时候必须在启动类上再加上
我在父工程中,把版本改成了2.9的结局了这个问题,当然这是在下面的课程学习解决的,把这个放在这里,记录一下,版本不匹配的问题
遇见之上的问题,我决定看一下,swagger里边应该怎么用
前后端,使用api交互,前后端相互独立,松耦合,前后端甚至可以在不同的服务器上
公司中为了解决前后端,配合不起来,会实时更新API,降低继承的风险;
前端测试后端接口的数据:早期使用postman,后端人员实时更新最新的消息
首先,Swagger 世界上最流行的api框架
RestFul API文档在线自动生成工具=>api文档与pai定义同步更新
支持同步pai测试
需要两个jar包
swagger2swagger-ui
导入包以后创建一个配置文件
进行简单配置,只加入这几个注解以后
@Configuration
@EnableSwagger2
public class SwaggerConfig {
}
也运行出来了页面
配置swargger,Docket是swargger的与一个bean实例
那就让其返回一个api,观察
只需要返回一个documentationType对象即可,
更新版本以后能正确访问出来了
测试使用
可以看到点了一下相当于执行了
看了以下删除的
加一些中文注解 方便api测试
@Api:在
@ApiOperation(value = "逻辑删除讲师")
给方法起注释
给属性起注释
效果图
