Swagger的目标是为REST API 定义一个标准的,与语言无关的接口,使人和计算机在看不到源码或者看不到文档或者不能通过网络流量检测的情况下能发现和理解各种服务的功能。当服务通过Swagger定义,消费者就能与远程的服务互动通过少量的实现逻辑。类似于低级编程接口,Swagger去掉了调用服务时的很多猜测。
Swagger 是一个用于生成、描述和调用 RESTful 接口的 Web 服务。通俗的来讲,Swagger 就是将项目中所有(想要暴露的)接口展现在页面上,并且可以进行接口调用和测试的服务。
Swagger官网地址:https://swagger.io/
在开始开发之前,我们需要准备一些环境配置:
打开idea -> file -> Nwe -> Project ,
如图,勾选填写相关的配置信息:
勾选一些初始化的依赖配置:
工程搭建完成:
首先,我们要去 mvnrepository 查询 Swagger 的依赖
将依赖引入工程中:
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger2</artifactId>
<version>2.7.0</version>
</dependency>
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger-ui</artifactId>
<version>2.7.0</version>
</dependency>
package com.example.swagger_test.controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
/**
* @author xiaoZhao
* @date 2022/10/24
* @describe
*/
@RestController
public class TestController {
@GetMapping("hello")
public String hello(){
return "hello swagger";
}
}
编写Swagger配置类:
import org.springframework.context.annotation.Configuration;
import springfox.documentation.swagger2.annotations.EnableSwagger2;
/**
* @author xiaoZhao
* @date 2022/10/24
* @describe
*/
@Configuration
@EnableSwagger2 // 开启Swagger2
public class SwaggerConfig {
// 使用默认配置
}
访问:http://localhost:8080/swagger-ui.html 进入Swagger管理页面
从上图可以看到,接口文档详细信息、接口信息等
配置Swagger信息:
package com.example.swagger_test.config;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.service.Contact;
import springfox.documentation.service.VendorExtension;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;
import java.util.ArrayList;
/**
* @author xiaoZhao
* @date 2022/10/24
* @describe
*/
@Configuration
@EnableSwagger2 // 开启Swagger2
public class SwaggerConfig {
// 配置Swagger Docket
@Bean
public Docket docket(){
return new Docket(DocumentationType.SWAGGER_2)
.apiInfo(apiInfo());
}
// 配置Swagger信息
private ApiInfo apiInfo(){
// 作者信息
Contact contact = new Contact("小赵", "https://blog.csdn.net/Zp_insist?type=blog", "test@qq.com");
return new ApiInfo("测试 Swagger API",
"一个工程用来测试Swagger的使用",
"1.0",
"https://blog.csdn.net/Zp_insist?type=blog",
contact,
"Apache 2.0",
"http://www.apache.org/licenses/LICENSE-2.0",
new ArrayList<VendorExtension>());
}
}
重启工程进入Swagger管理页面