靜態元素 (Static Elements) 的單元測試, 以 DateTime.Now 為例

Unit Test for Static Elements (DateTime.Now) in ASP.NET Core 6 MVC

前言

接續前一篇 樂透開獎 的例子, 假設有一個新的需求: "樂透開奬不是每天開, 而是固定每個月的 5 日才會開獎".

因此, 程式要加一個當前日期時間的判斷.

• 若為 5 日才可開獎, 並回傳開獎的結果.
• 若為其它日期, 就不可開獎, 並回傳警告訊息.
  這個邏輯要如何測試呢? 總不能等到每個月 5 日, 或者調整筆電的系統時間, 才來測試吧.

以下係採 參考文件2.. "An interface that wraps the DateTime.Now" 方式進行演練及實作.

完整範例可由 GitHub 下載.

非決定性元素 (Non-Deterministic Elements) 的單元測試, 以亂數 (Random) 為例

Unit Test for Non-Deterministic Elements (Random class) in ASP.NET Core 6 MVC

前言

非決定性元素 (Non-Deterministic Elements) 是指在軟體開發中, 其行為或輸出無法預先確定或不會每次都產生相同結果的元素.
這種不確定性通常是由於外部因素, 隨機性, 系統狀態或執行環境的變化所引起.
非決定性元素在測試時可能帶來挑戰, 因為相同的輸入不一定導致相同的輸出.

以下是一些常見的非決定性元素範例:

• 隨機數生成 (如 Random 類別): 隨機數生成器產生的數字是不可預測的, 每次調用可能得到不同的結果.
• GUID 生成 (如 Guid.NewGuid()) : 全局唯一標識符 (GUID) 生成器每次調用時都會產生一個唯一的值.
• 當前日期和時間 (如 DateTime.Now) : 當前的日期和時間在每次調用時都會不同, 這取決於當前的系統時間.

在單元測試中處理非決定性元素時, 一個常用的策略是通過封裝 (Wrapping) 這些元素於可控的介面後, 使用模擬或替身物件 (Test Doubles) 來提供可預測的輸出. 這樣可以減少測試的不確定性, 並提高測試的可靠性和重複性.

以下茲以一個 ASP.NET Core 6 MVC 的專案, 以 Random 類別為例, 進行演練.

完整範例可由 GitHub 下載.

如何在 DBeaver Community Edition 23.1.0 連接至 SAP ASE 16.0

1. 前言

由於 SAP ASE 16.0 GUI 管理工具, 有的不再提供下載 (Sybase Central), 有的因為 Adobe Flash Player 停用, 而不再提供管理介面 (Cockpit), 有的則可能受限筆者的能力或環境, 一直安裝不起來 (AMC: Administration and Management Center), 故只好找看看有沒有第3方的免費工具可以使用.
筆者找到了 DBeaver 這個以 Java 開發的工具, 它有 Community 及 Commercial 版本; 前者免費, 後者要付費. 當然, 付費可以有比較多的功能 (例如: 支援非關聯式資料來源, MongoDB, Redis ... 等).
但就存取 SAP ASE 16.0 而言, Community Edition 已經足夠.
安裝軟體看來很容易, 只要 [下一步] 就可無腦完成; 但在開始使用後, 筆者有遇到問題, 想說還是記錄一下.

如何在 Windows 10 安裝 SAP ASE 16.0

1. 前言

由於專案資料整合的需求, 需連接至原有 SAP ASE 16.0 進行資料存取, 因此先行在自己筆電建立虛擬機器 (VM), 安裝 SAP ASE 16.0. 所謂的 ASE (Adaptive Server Enterprise) 其實就是 Sybase.
Sybase 在 20 幾年前是蠻好的資料庫, 當年曾採用 PowerBuilder 開發應用程式, 並利用 Sybase 的 Open Client / Open Server 的技術, 與 IBM 大型主機的 CICS/COBOL 串接.
當時資料庫的三大供應商是 Oracle / Sybase / Informix, 後來 Sybase 被 SAP 收購, Informix 被 IBM 收購.
筆者目前常接觸的, 大概是 MSSQL (與 Sybase 同源), Oracle 及 MariaDB (or 付費版的 MySQL).

ASP.NET Core 6 使用 Token-based 身份認證與授權 (JWT) 演練

1. 前言

本文主要參考 (Will保哥) 如何在 ASP.NET Core 6 使用 Token-based 身份認證與授權 (JWT) 的文章為基礎作演練.
保哥的文章是以 Minimal API + .NET CLI + Visual Studio Code 為基礎.
筆者的演練係以 Controller/Action API + Visual Studo 2022 為演練的對象; 過程中有遇到一些錯誤, 也一併記錄下來 (有些可能蠻低級的錯誤 ^^), 以供筆者或其它有興趣者留作參考.
本文僅處理產出 JWT access token 及驗證為範圍, 不含 JWT refresh token, 登出 的功能.

原始程式及文件可參考 GitHub.

ASP.NET Core 6 MVC 相依性注入之物件生命週期範例

An example for DI instance lifetime in ASP.NET Core 6 MVC

前言

在 ASP.NET Core 6 的開發框架下, 相依性注入 (Dependency Injection) 是跟以往 ASP.NET MVC 5 有很大不同的其中一項技術.

本篇文章, 主要是模仿參考文件 [1] 的範例, 進行演練.

在經由演練之後, 對於 ASP.NET Core 6 MVC 內建的 DI Container 套件, 也多了一份認識.

原始程式可參考 GitHub 的連結

如何利用 Visual Studio 2022 開發 Web App，並透過 GitHub Action (CI/CD) 進行建置、部署至 Azure App Service

一. 前言

長久以來，一直很想試一下CI/CD，最近看到了 參考文件[1..] 的影片後，決定開始動手；將整個練習的過程記錄下來，供日後參考之用。

茲區分以下主要步驟作說明：
(一) 建立 ASP.NET MVC 專案
(二) 加入至 Git 版控，並推送至 GitHub
(三) 建立 GitHub CI/CD pipeline
(四) 將 .yml 檔 "認可並推送"，此時會啟動 GitHub Actions 的執行
(五) 檢視網頁
(六) 改一下網頁內容，認可及推送，確定可以引發 GitHub Actions

2022.12.25 補充：
(七) 記得清理相關的資源群組 Resource Group

2022.12.28 補充:
(八) 處理設定 Hosting Plan 時，無法選擇免費 F1 主機的問題