搜尋澳門生活誌

Spring Boot 06 - Spring Boot Web 調試工具

MacauYeah・2024-08-02

之前兩節，都一直在講怎樣寫code，也介紹了Test Case的好。若為初次接觸，Spring有很多設定需要摸索，若開始時就設定錯誤，對不少人來講都會有很大打擊。在這裏，筆者就介紹一些vscode和spring的工具，可以讓IDE多幫忙一下，減少走歪路的機會。 vscode插件以下兩個插件，都在於提示用戶設定。 Spring Boot Dashboard (vscjava.vscode-spring-boot-dashboard) 可以那它來運作spring boot app，省去找尋main 位置的麻煩綜覽整個程式中的所有Bean (Bean是一個很重要的元素，日後會再提及) 若程式為Spring boot web，可以顯示所 http endpoint。 Spring Boot Tools (vmware.vscode-spring-boot) 檢查設定檔的設定值有沒有寫錯（application*.properties， application*.yml）綜覽檔案中的有以@為首的與spring相關的元素（檔案很大時就會有用）可以在IDE運行spring時，查看@元素的bean資訊 (not works ?, 加了actuator也是沒有看見) Spring Initializr（vscjava.vscode-spring-initializr）經網絡初始化spring 專案的依賴引用設定 Maven for Java (vscjava.vscode-maven) 若大家在使用Spring Initializr時，選取了maven作管理工具，那麼這插件就可以在後續幫忙更新引用。若專案的Spring 及㡳層引用有變，vscode也需要它來引用更新。這是java 開發工具包(vscjava)的其中一員，它的其他插件也可以順帶安裝。調試工具 - open api / swagger-ui 如果我們在開發Web http API ，其實都是為了該某個客戶端使用。但如果該客端明白我們的API該怎樣使用，大家總不會逐個連結，自行編寫使用手冊及範例吧。所以就有了open api 和 swagger-ui 的旦生。 open api，就是一個公認的使用手冊標準，我們只要在spring-web中加入 springdoc-openapi-starter-webmvc-ui 的程式庫，就可以自動為我們的controller 生成 open api 的說明檔。更強大的是，這個程式庫可以利用剛生成的open api，配上 swagger-ui ，自動測生一個可供測試的頁面。這個頁面可以供碼農們直接操作，也會產生對應的 curl 指令，讓碼農們可以在任何的主機上重複。這樣，那麼是沒有太多解釋的說明文檔也可以使用。做法很簡單，在pom.xml中加入依賴。 org.springdoc springdoc-openapi-starter-webmvc-ui 2.5.0 (由於安全性問題，上述程式碼未能完整顯示，請參見文末完成Source Code) 然後我們就可以加入Controller，運行 spring 後，我們可以在 http://localhost:8080/swagger-ui/index.html 找到 swagger 的頁面，然後就可以在 ui 上測試API了。躲在Proxy背後的 swagger 如果你跟筆者一樣，使用 code-server 或 github codespaces ，你就不能很隨意地連接到 8080 端口。你只能經過Http Proxy去訪問。這樣 open api的原有的設定就不合用了。這時我們需要自行修改 open api 的 bean，加入我們真正的根路徑。然後筆者使用 code-server，而IDE只會在port 9000上執行，它對外的前置路徑會是 http://localhost:9000/proxy/8080/。 @Bean public OpenAPI springShopOpenAPI() { Server server = new Server(); server.setUrl("http://localhost:9000/proxy/8080/"); return new OpenAPI().servers(List.of(server)); } (由於安全性問題，上述程式碼未能完整顯示，請參見文末完成Source Code) 然後訪問 http://localhost:9000/proxy/8080/swagger-ui/index.html，還會發現 "Failed to load remote configuration." 。但你可以在 "explore" 搜尋欄位內貼上 http://localhost:9000/proxy/8080/v3/api-docs，再一次搜尋檔案，就回復正常了。註：如果你熟習Nginx這類Reverse Proxy ，你的環境有條件直接修改 Request Header，加入X-Forwarded-*，就不用煩惱寫Bean了，也不用手動在explore裏重新修正api-docs的位置。詳見 https://springdoc.org/index.html#how-can-i-deploy-springdoc-openapi-starter-webmvc-ui-behind-a-reverse-proxy Controller的繼承 Spring Controller的 @ 標記 (Annotation) ，其實支援繼承的。經Spring 生成的 api docs，也有如何效果。例如以下程式碼 public class ParentController { @GetMapping("/postfix") public String postfix(){ return "this is postfix"; } } @RestController @RequestMapping("/api") public class ChildController extends ParentController { @GetMapping("/direct") public String directCall() { return "direct result"; } } (由於安全性問題，上述程式碼未能完整顯示，請參見文末完成Source Code) 在ChildController的實例中，它會有兩個API，分別是 /api/direct /api/prefix 它支援Java Function Overwrite（覆寫），但不能改 @ 標記，以下就是一個錯的例子 @RestController @RequestMapping("/api") public class ChildController extends ParentController { @GetMapping("/Overwrite") // 把這個 @ 行刪了才能正常執行 public String postfix(){ return "this is Overwrite"; } }(由於安全性問題，上述程式碼未能完整顯示，請參見文末完成Source Code) Source Code spring boot web api doc

搜尋結果

塵世美小鎮『斯柳江卡』Slyudyanka

為食推介 | 5間能量提供站！高卡CP給你最直接有效的心靈治愈！

【新加坡】§美食§ 逸群海南雞飯 Yet Con Restaurant ~ 擁有60年歷史的傳統味道

【韓國。首爾】§美食§ 八色烤肉(東大門店) 팔색삼겹살 ~ 一次過挑戰八種口味的五花肉

【馬交慳多拿baby】電子優惠計劃，各大移動支付平台優惠集合 - 10.05.2022

金沙城中心及澳門金沙推出聖誕及新年節慶菜單

【韓國。釜山】※景點※ BIFF釜山電影殿堂 (부산 영화의 전당) ~ 韓國的電影殿堂, 一起來走紅地毯吧!

玩滑板可以玩得有幾型？

颱風“杜蘇芮”最新走勢

【澳洲。悉尼】✰購物✰ 維多利亞女王大廈 Queen Victoria Building, QVB

Spring Boot 06 - Spring Boot Web 調試工具

M仔日記 │ 高雄KHH More Premium Lounge

真一個人，真的這樣難嗎？如果不難，為何你不去好好愛他一個

日久不一定生情，但一定見人心

如懸浮於時空宇宙的 ※屏山峽谷※

搜尋結果

塵世美小鎮『斯柳江卡』Slyudyanka

為食推介 | 5間能量提供站！高卡CP給你最直接有效的心靈治愈！

【新加坡】§美食§ 逸群海南雞飯 Yet Con Restaurant ~ 擁有60年歷史的傳統味道

【韓國。首爾】§美食§ 八色烤肉(東大門店) 팔색삼겹살 ~ 一次過挑戰八種口味的五花肉

【馬交慳多拿baby】電子優惠計劃，各大移動支付平台優惠集合 - 10.05.2022

金沙城中心及澳門金沙 推出聖誕及新年節慶菜單

【韓國。釜山】※景點※ BIFF釜山電影殿堂 (부산 영화의 전당) ~ 韓國的電影殿堂, 一起來走紅地毯吧!

玩滑板可以玩得有幾型？

颱風“杜蘇芮”最新走勢

【澳洲。悉尼】✰購物✰ 維多利亞女王大廈 Queen Victoria Building, QVB

Spring Boot 06 - Spring Boot Web 調試工具

M仔日記 │ 高雄KHH More Premium Lounge

真一個人，真的這樣難嗎？如果不難，為何你不去好好愛他一個

日久不一定生情，但一定見人心

如懸浮於時空宇宙的 ※屏山峽谷※

金沙城中心及澳門金沙推出聖誕及新年節慶菜單