freemarker使用说明_SpringBoot+Swagger2集成详细说明

SpringBoot+Swagger2集成详细说明

引言：

为什么使用Swagger？

在Vue没有出来之前，都是前后端在一起：

• 后端用的SSM或者SSH框架

• 前端完全就是静态页面+模板引擎。例如：JSP开发久的人应该听说过，和现在的Thymeleaf、 Velocity、FreeMarker 类似

在Vue出来之后，进入真正的前后端分离时代：

• 后端依然可以是SSM架构，而现在大厂都在使用微服务SpringBoot、SpringCloud等

• 前端就独立出来了，只管呈现效果也就是是三层架构的视图层

为什么叫前后端分离呢？

分离就是各自开发自己的，互不干扰

优点：

• 前端可以不用等后端人员开发完在测试，直接就可以使用Json伪造数据测试，例如：JsonServer工具

• 可以部署在不同的服务器上

• 有新的项目可以随时拆分模块

缺点：

• 此时就需要在招专业开发前端的人员，这就是老板的事了。。。

Swagger简介：

Swagger是一个流行的API开发框架，Swagger容许用户使用Swagger编辑器描述OAS 3.0API，并使用SwaggerUI可视化并自动生成OAS 3.0中定义的API文档。

Swagger可以对整个API开发周期提供一个完整框架，解决调试过程中的各种问题，包括API设计，开发，测试，完档，并且几乎支持所有语言。

Swagger的用途来了：

问题：

前后端分离联调，前后端人员无法做到及时的调试？

当年的解决方案：

• 编写Word文档，及时更新(但是很难做到，一般容易忘记)

• 模拟测试后端接口：postman

• 后端开发完之后，提供接口，根据需求在调整

现在的解决方案：

• Api文档与API定义同步更新

• 直接运行，在线测试后端接口

• 对多种编程语言的支持

SpringBoot集成Swagger：

1.建立SpringBoot-Web项目