搜尋澳門生活誌

Spring boot 10 - openapi 生成器 - spring boot java client

MacauYeah・2025-08-19

之前我們在介紹Spring Boot Web 調試工具，就試安裝 openapi 相關的元件。其實 openapi 並不單是為了提供 swagger 測試介面，它主要是提供一個描述的方式，讓我們針對一個特定 openapi 文件，生成對應的 api server 或 api client 接口。也就是，如果 server 方有提供該文件，道理上可以經 openapi 的工具，生成一個可以直接訪問 server 的 client library。本節，可以沿用之前的 spring boot web api doc ，為它產生一個client library 作為實驗。在生成 client library 之前，我們還需要一個工具 openapigeneratorcli 。最簡單的取得方式，就是經過 npm ，在你需要生成 client library 的專案中，安裝你需要的 openapigeneratorcli 版本。 npm install @openapitoolsopenapigeneratorcli 那怕你不是使用 nodejs 作為開發，也可以經過這個方法安裝。它只提供使用 cmd 指令的捷徑。生成 Java Client Library 我們先把 backend server 起好 cd somewhere amp;amp; mvn springbootrun，然後使用 openapigeneratorcli 去生成以 java spring boot 3 為底的 client library 。 npx openapigeneratorcli generate i httplocalhost8080v3apidocs apipackage io.github.macauyeah.springboot.tutorial.openapiclient.api modelpackage io.github.macauyeah.springboot.tutorial.openapiclient.model invokerpackage io.github.macauyeah.springboot.tutorial.openapiclient.invoker groupid io.github.macauyeah.springboot.tutorial artifactid springbootwebapiopenapiclient artifactversion 0.0.1SNAPSHOT g java p useJakartaEe=true p useSpringBoot3=true library webclient o springbootwebapiopenapiclient 生成的 source code 就像是 springbootwebapiopenapiclient ，具體的使用方式，可以看看測試用例 ApiControllerApiTest.java private final ApiControllerApi api = new ApiControllerApi; @Test public void postDateQueryTest default call ApiDateRequest apiDateRequest = new ApiDateRequest; apiDateRequest.setInputDateOffsetDateTime.now; LOG.debugquot;default web client postDateQueryquot;, api.postDateQueryapiDateRequest.block; replace webClient in ApiClient if you have special auth config on webClient, you can also change basePath during new obj creation ObjectMapper mapper = new ObjectMapper; mapper.setDateFormatnew SimpleDateFormat; mapper.registerModulenew JavaTimeModule; WebClient webClient = WebClient.builder .codecsconfigurer gt; configurer.defaultCodecs.jackson2JsonDecodernew Jackson2JsonDecodermapper; configurer.defaultCodecs.jackson2JsonEncodernew Jackson2JsonEncodermapper; .build; ApiControllerApi api2 = new ApiControllerApi new ApiClientwebClient .setBasePathquot;httplocalhost8080quot;; LOG.debugquot;create api2 by local web client postDateQueryquot;, api2.postDateQueryapiDateRequest.block; use webClient directly String response = webClient.post.uriquot;httplocalhost8080apirecordquot;.bodyValueapiDateRequest.retrieve .bodyToMonoString.class.block; LOG.debugquot;request by local web client postDateQueryquot;, response; 上述例子中，如果大家沒有任何特殊要求，其實經過 api.postDateQueryapiDateRequest.block 就完成了。有需要改 api endpoint 的，只要生成新的 ApiClient 並設定 basePath new ApiClient.setBasePathquot;XXXXXXquot; 就好。真的要加入更多權限設定，就需要生成新的 ApiClient 並設定 webClient new ApiClientwebClient 這個生成的 Java Client Library 道理上還是要經過 maven 等打包，變成 jar 檔，才能被其他 Java 專案所引用。筆者就建議大家直接把成生的視為獨立的 module sub module 存放，其他專案就以 maven dependency 的方式引用。想要混合現有專案，動態生成專案內某些 java package，暫時不太可行。因為它也有大量的 dependency ，交由 openapigeneratorcli 自己管理會比較好，它們升級時，你也可以完整升級。 openapigeneratorcli httpsgithub.comOpenAPIToolsopenapigeneratorcli springbootwebapiopenapiclient

搜尋結果

《十年...刃記》”Blademark...a decade“

2021澳門政府推出電子消費優惠，一圖睇清你最適合的使用方式！

酷航澳門飛新加坡來回連稅HKD1,226起！買行李套餐另有9折優惠碼！

長榮航空輕促銷，澳門出發飛台灣來回連稅MOP1,459起！

長榮航空雙11促銷，澳門出發飛台灣來回連稅MOP1,391起！

長榮航空美加優惠！澳門出發來回連稅MOP3,933起！

【雙 11 系列】Hotels.com 購物節訂房咪走寶

【雙 11 系列】NIKE 折上折優惠

土耳其航空葡國航點優惠，香港出發來回連稅HKD4,131起！

【積分攻略】日本城 J Fun 會員計劃介紹

養生雲南野菌珍饈 MGM金殿堂呈獻

架設 Squid proxy，作為國産 Linux RPM 安裝包更新的 RPM proxy

Spring boot 10 - openapi 生成器 - spring boot java client

MENARD X MEL iEong！日本老牌護膚化妝品登陸文藝門

【澳門美食】糅合上海、江蘇和浙江地區的特色菜— 澳門威尼斯人醉江南