springboot 整合swagger2

相信很多人都用过postman,使用postman其实可以很简便的进行接口调试,但是呢,每次还要写url,以及要添加参数名字(很容易写错)。所以啊,swagger2优势就体现出来了,它只需要添加少量注解即可在项目下调试接口,并且可以根据项目是否是测试还是生产环境,可以显示或禁止页面接口调试,介绍就到这里,开始写整合部分。

一.maven添加依赖

此处使用的是2.7.0版本,下面的ui二选一即可,springfox-swagger-ui是官方提供的UI界面(本人一直使用的是这个),swagger-bootstrap-ui是基于左右菜单风格,GitHub项目地址:GitHub - xiaoymin/swagger-bootstrap-ui: Knife4j is a set of Swagger2 and OpenAPI3 All-in-one enhancement solution


	io.springfox
	springfox-swagger2
	2.7.0



	io.springfox
	springfox-swagger-ui
	2.7.0



	com.github.xiaoymin
	swagger-bootstrap-ui
	1.6

二.swagger2配置文件

本人喜欢将swagger2一些参数写到配置文件中,方便以后修改,也可以将其写死。在application.yml中添加以下配置。enable为true是表示在swagger-ui.html中显示接口。

swagger:
  enable: true
  info:
    version: 0.1
    title: 兮川项目的接口
    description: 薛定谔的猫,你不去验证,就无法知道真假
  

你可能感兴趣的:(SpringBoot,后端,springboot,swagger2)