网上看了很多swagger的教程,大多已经过时。希望同行们写教程附上版本,以免给别人造成麻烦。
swagger官方版之前需要引两个maven依赖,swagger 本体和ui,后来有一个spring4all,配置简单一些。但我的springBoot项目发现上述两个办法失效。后来看了下是springBoot版本太高。
我的教程基于 springBoot 2.4 + swagger3
swagger3简单的吓人。引入依赖,然后重启项目就可以了…
<!--swagger-->
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-boot-starter</artifactId>
<version>3.0.0</version>
</dependency>
需要注意的是新版本swagger默认地址变了 :
http://localhost:8081/fzydemo/swagger-ui/index.html
我比较喜欢启动的时候打印一下此地址,可以直接点击看后台api接口 :
至于swagger的其他功能也有很多,包括接口的注释类的解释等,网上教程很多,不做赘述了。