swagger簡介

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

1. 新建一個Springboot項目
2. 寫一個controller
3. 配置Swagger的Config類
   

• 配置swagger實例docket