API文件易混淆術語:SpringFox、SpringDoc、Swagger、OpenAPI3

Spring Boot生成API文件的一些易混淆術語:SpringFox、SpringDoc、Swagger、OpenAPI3。

OpenAPI和Swagger

OpenAPI 規範(OAS)為 RESTful API 定義了一個標準、與程式語言無關的 API 描述規範。Swagger 也是一個規範,是 OpenAPI 規範的前身。Swagger 規範已於 2015 年捐贈給 Linux 基金會後改名為 OpenAPI,並定義最新的規範為 OpenAPI 3。0。所以現在的 Swagger 3。0 就是 OpenAPI 3。0。

通常我們所說的 Swagger 是指由 SmartBear Software 開發維護的一套用於實現 OpenAPI 規範的工具組合名稱。Swagger 工具包含開源、免費和商用工具的組合,可用於整個 API 生命週期的開發。

OpenAPI 是一個規範,而 Swagger 是用於實現規範的工具組合。

SpringFox和SpringDoc專案

SpringFox是 Spring 社群非官方維護的一個專案,主要就是幫助使用者將Swagger整合到Spring 中,在停更了2年多之後,近期終於推出了3。0。0版本,支援了開發者期盼已久的OpenApi 3規範。

SpringFox專案相關網站:

http://springfox。github。io/springfox/

https://github。com/springfox/springfox

API文件易混淆術語:SpringFox、SpringDoc、Swagger、OpenAPI3

SpringDoc 也是 Spring 社群維護的一個非官方專案,幫助使用者將 Swagger 3 整合到 Spring 中。

SpringDoc 支援 Swagger 頁面 Oauth2 登入,相較於 SpringFox 而言,它在github上的維護更新比較頻繁。

SpringDoc專案相關網站:

https://springdoc。org/

https://github。com/springdoc/springdoc-openapi

API文件易混淆術語:SpringFox、SpringDoc、Swagger、OpenAPI3

API文件易混淆術語:SpringFox、SpringDoc、Swagger、OpenAPI3