Swagger
學習目標:
- 瞭解Swagger的作用和概念
- 瞭解前後端分離
- 在springboot中集成swagger
Swagger簡介
前後端分離【動靜分離】
當前最主流的前後分離的一個技術棧:Vue+SpringBoot
後端時代:前端用dreamwevar把圖畫出來,生成HTML代碼,那時候前端不值錢,java程序員工資特別高,前端只用管靜態頁面;而後端程序員拿到HTML頁面之後,可以通過模板引擎JSP填充數據,後端是主力。
前後端分離時代:
- 後端:controller層、service層和dao層【後端團隊】
- 前端:前端控制層,視圖層【前端團隊】
- 僞造後端數據,json。已經存在了,不需要後端,前端工程依舊能跑起來
- 前後端通過API交互
- 前後端相對獨立,鬆耦合;
- 前後端甚至可以部署在不同的服務器上
產生一個問題:
-
前後端繼承聯調,前端人員和後端人員無法做到“及時協商,儘早解決”,最終導致問題集中爆發
解決方案:
- 首先指定schema[計劃的提綱],實時更新最新的API,降低集成的風險;
- 早些年:指定word計劃;
- 前後端分離:
- 前端測試後端接口:postman
- 後端提供接口,需要實時更新最新的消息及改動
Swagger
-
號稱世界上最流行的API框架;
-
RestFul API文檔在線自動生成工具=>API文檔與API定義同步更新
-
直接運行,可在線測試API接口;
-
支持多種語言:java php
官網:https://swagger.io/
在項目中使用Swagger需要Springfox:
- swagger
- ui
SpringBoot繼承Swagger
- 新建一個Springboot項目
- 寫一個controller
- 配置Swagger的Config類
- 配置swagger實例docket