代碼優先還是設計優先?說說API開發技術(二)
【設計優先:OpenAPI生成器】
這一節要討論的內容是如何通過API設計來生成客戶端訪問和服務器端的存根代碼。
OpenAPI Generator可以自動生成API客戶端庫(SDK)、服務器存根、文檔和配置(支持2.0和3.0)。
在這篇文章編寫的時刻,最穩定的OpenAPI版本是4.3.0。
核心程序:
命令行:
Maven插件:
Gradle插件:
直接下載核心程序jar包。
https://repo1.maven.org/maven2/org/openapitools/openapi-generator-cli/4.3.0/openapi-generator-cli-4.3.0.jar
腳本下載:
https://github.com/OpenAPITools/openapi-generator/blob/master/bin/utils/openapi-generator-cli.sh
從此處下載源碼:
https://github.com/OpenAPITools/openapi-generator.git
運行如下命令:
mvn clean install
brew install openapi-generator
Docker鏡像:
https://hub.docker.com/r/openapitools/openapi-generator-cli/
https://hub.docker.com/r/openapitools/openapi-generator-online/
openapi-generator-online鏡像可以作為一個自托管的web應用和API來生成代碼。這個容器可以被整合到CI流水線中,至少需要兩個HTTP請求和一些docker?生態來訪問生成的代碼。
npm install @openapitools/openapi-generator-cli -g
API
版權聲明:本文內容由網絡用戶投稿,版權歸原作者所有,本站不擁有其著作權,亦不承擔相應法律責任。如果您發現本站中有涉嫌抄襲或描述失實的內容,請聯系我們jiasou666@gmail.com 處理,核實后本網站將在24小時內刪除侵權內容。