后端web开发框架(五):Swagger简介及使用

一、Swagger自动生成接口文档

1. 简介：  Swagger UI允许任何人都可以可视化API资源并与之交互，无需任何实现逻辑。它根据OpenAPI规范自动生成的、具有可视化文档，可简化后端实现和客户端使用。后端修改接口后，可以实时更新接口文档，这样前端开发能拿到最新的接口信息。

2. 依赖项：

  <dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger-ui</artifactId>
    <version>3.0.0</version>
</dependency>

<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger2</artifactId>
    <version>3.0.0</version>
</dependency>
 

3. Swagger配置类

(1). Swagger配置类的壳：

@Configuration

@EnableSwagger2   //开启Swagger2

public class SwaggerConfig{

}

(2). 通常@Configuration 和 @Bean 两个注解搭配使用

示例࿱