Swagger配置

Swagger简介

前后端分离

• 后端：后端控制层、服务层、数据访问层
• 前端：前端控制层、视图层
  • 前端伪造数据，json，不需要数据也能跑起来
• 前后端如何交互===》通过API沟通
• 前后端相对独立，送耦合
• 前后端甚至可能部署在不同的服务器上

产生一个问题

• 前后端集成联调，前后端无法做到即时协商，前端加了字段后端需要更改很多东西

解决方案

• 指定Schema计划制定的提纲，实时更新最新的API，降低集成风险
• 早些年使用Word文档
• 前后端分离
  • 前端要使用数据时要确保数据适合前端界面，如果后端传递来的数据不行，就会产生一些问题，所以之前使用postman工具来测试请求，来查看数据
  • 后端提供接口，需要实时更新最新的消息改动
  • 思想的不统一，前后端容易打架，中途加需求也容易打项目经理，所以程序员要好好锻炼身体，争取打赢

Swagger

• 号称世界上最流行的API框架
• API文档与API定义同步更新
• 代码一更新，api就更新
• 直接运行，在线测试API接口
• 支持多种语言

SpringBoot集成Swagger

• <!-- https://mvnrepository.com/artifact/io.springfox/springfox-swagger2 -->
  <dependency>
      <groupId>io.springfox</groupId>
      <artifactId>springfox-swagger2</artifactId>
      <version>2.9.2</version>
  </dependency>
  <!-- https://mvnrepository.com/artifact/io.springfox/springfox-swagger-ui -->
  <dependency>
      <groupId>io.springfox</groupId>
      <artifactId>springfox-swagger-ui</artifactId>
      <version>2.9.2</version>
  </dependency>
  
  

• @Configuration
  @EnableSwagger2
  public class SwaggerConfig {
       
  }