微軟從 ASP.NET Core 9 開始正式支援 OpenAPI 規格，並推出 Microsoft.AspNetCore.OpenApi NuGet 套件，在建立 ASP.NET Core Web API 專案時，預設就會加入可以產生 OpenAI 規格的端點。不過，對許多開發人員來說，常用的 Swagger UI 介面卻不見了。今天這篇文章我就來說說怎樣把 Swagger UI 加回專案中。
... 繼續閱讀 ...
前陣子在企業授課 OAuth 2.0 的時候，我原本想現場示範走 Google 的 OAuth 2.0 流程，並且在取得 Access Token 之後怎樣透過原始的 REST API 發信。原本以為這是個很簡單的任務，誰知道膝蓋中了一箭，拿 Token 都很簡單，唯讀「發信」的困難度超出了我的想像，原因無他，就是 Google 的參考文件實在是寫太爛了。這篇文章我打算跟大家說個官方文件沒寫的資訊，教大家怎樣順利透過 Gmail API 發出郵件。
... 繼續閱讀 ...
最近看了一本書 Tidy First?: A Personal Exercise in Empirical Software Design，作者是令人景仰的 Kent Beck 大神，他是一位擁有 Wikipedia 頁面的人物，也是美國著名的軟體工程師和作家，在軟體工程領域有著深遠的影響力。這本書整理了 32 個「整理程式碼」的心法，他並不是一本強調 Clean Code 或 Refactoring 的技巧，而是一些更細微的、個人層面的軟體設計考量，這些技巧都是作者在多年軟體開發經驗中的心得，也是他在日常開發中的一些習慣，我真的越看越亢奮，因為很多內容其實也跟我二十多年的開發經驗相吻合，有種為什麼不早點看到這本書的感覺，我特別整理了這本書的讀後心得，希望大家可以從中獲益。這本書在台灣已有翻譯書，名為 先整理一下？｜個人層面的軟體設計考量，大家有興趣也可以買來看看。
... 繼續閱讀 ...
前幾天我們公司有個網站準備上一個新版，工程師發出 PR (Pull request) 之後請我進行程式碼審核(Code Review)，結果我發現他本次的修正項目不太合理，他改了一個前端套件的資料夾名稱。我當下覺得不妙，一個已經測試數月，也準備上線的網站，怎麼還會在最後一刻修改資料夾名稱呢？我反問工程師為什麼要改這些地方時，卻得到一個我不是很滿意的回答，因此退件請他重改。這不是一個什麼嚴重的技術問題，改改資料夾名稱就正常了，但是卻又激起我追根究底的柯南精神，真相只有一個，我要找出來！🕵️♂️
... 繼續閱讀 ...
我經常利用不同的連結(Link)來管理檔案和目錄，以確保系統的設定隨時可以透過雲端硬碟同步與備份，相當便利。在 Windows 系統中有三種不同的連結方式，分別是 符號連結(Symbolic Link)、硬連結(Hard Link)和目錄聯接(Directory Junction)。這三種連結方式各有其特性和用途，所以我打算針對這三種連結方式進行比較，幫助大家更好地理解它們之間的差異。
... 繼續閱讀 ...