Spring Boot集成Restful Api在线文档接口调试工具 Swagger

文章目录

一、Swagger简介

Swagger的目标是为REST API 定义一个标准的，与语言无关的接口，使人和计算机在看不到源码或者看不到文档或者不能通过网络流量检测的情况下能发现和理解各种服务的功能。当服务通过Swagger定义，消费者就能与远程的服务互动通过少量的实现逻辑。类似于低级编程接口，Swagger去掉了调用服务时的很多猜测。

Swagger 是一个用于生成、描述和调用 RESTful 接口的 Web 服务。通俗的来讲，Swagger 就是将项目中所有（想要暴露的）接口展现在页面上，并且可以进行接口调用和测试的服务。

Swagger官网地址：https://swagger.io/

Swagger有什么用？

• 将项目中所有的接口展现在页面上，这样后端程序员就不需要专门为前端使用者编写专门的接口文档；
• 当接口更新之后，只需要修改代码中的 Swagger 描述就可以实时生成新的接口文档了，从而规避了接口文档老旧不能使用的问题；
• 通过 Swagger 页面，我们可以直接进行接口调用，降低了项目开发阶段的调试成本。

二、环境准备

在开始开发之前，我们需要准备一些环境配置:

• jdk 1.8 或其他更高版本
• 开发工具 IDEA
• 管理依赖 Maven

三、构建Spring Boot工程

打开i

dea -> file -> Nwe -> Project ,

如图，勾选填写相关的配置信息：

勾选一些初始化的依赖配置：

工程搭建完成：

四、引入Swagger依赖

首先，我们要去 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>

五、编写一个Test控制器

packagecom.example.swagger_test.controller;importorg.springframework.web.bind.annotation.GetMapping;importorg.springframework.web.bind.annotation.RestController;/**
 * @author xiaoZhao
 * @date 2022/10/24
 * @describe
 */@RestControllerpublicclassTestController{@GetMapping("hello")publicStringhello(){return"hello swagger";}}

六、配置Swagger

编写Swagger配置类：

importorg.springframework.context.annotation.Configuration;importspringfox.documentation.swagger2.annotations.EnableSwagger2;/**
 * @author xiaoZhao
 * @date 2022/10/24
 * @describe
 */@Configuration@EnableSwagger2// 开启Swagger2publicclassSwaggerConfig{// 使用默认配置}

访问：http://localhost:8080/swagger-ui.html 进入Swagger管理页面

从上图可以看到，接口文档详细信息、接口信息等

配置Swagger信息：

packagecom.example.swagger_test.config;importorg.springframework.context.annotation.Bean;importorg.springframework.context.annotation.Configuration;importspringfox.documentation.service.ApiInfo;importspringfox.documentation.service.Contact;importspringfox.documentation.service.VendorExtension;importspringfox.documentation.spi.DocumentationType;importspringfox.documentation.spring.web.plugins.Docket;importspringfox.documentation.swagger2.annotations.EnableSwagger2;importjava.util.ArrayList;/**
 * @author xiaoZhao
 * @date 2022/10/24
 * @describe
 */@Configuration@EnableSwagger2// 开启Swagger2publicclassSwaggerConfig{// 配置Swagger Docket@BeanpublicDocketdocket(){returnnewDocket(DocumentationType.SWAGGER_2).apiInfo(apiInfo());}// 配置Swagger信息privateApiInfoapiInfo(){// 作者信息Contact contact =newContact("小赵","https://blog.csdn.net/Zp_insist?type=blog","[email protected]");returnnewApiInfo("测试 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",newArrayList<VendorExtension>());}}

七、最终测试

重启工程进入Swagger管理页面