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
發佈了106 篇原創文章 · 獲贊 91 · 訪問量 4萬+
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章