AspNet6InDepth

深入學習 ASP.NET 6

1. ASP.NET 6 概述

   • 歷史和背景故事
   • 版本控制策略
   • 安裝
   • 專案結構
   • .NET SDK

2. ASP.NET 6 基礎知識

   • 使用 .NET SDK 的腳手架 ASP.NET 6 API 應用程式
   • 分析Program.cs文件
   • 依賴注入
     • 將物件註冊為單例生命週期
     • 將物件註冊為作用域生命週期
     • 將物件註冊為瞬態生命週期
   • 中介軟體
     • 概述
     • 製作自訂中介軟體
       • 透過實現IMiddleware介面
       • 透過注入RequestDelegate對象
       • 使用app.Use 、 app.Map 、 app.MapWhen 、 app.UseWhen和app.Run編寫內聯中間件
     • 靜態檔案中間件app.UseStaticFiles();
     • CORS 中介app.UseCors();
     • 新增 Correlationid 中間件
     • 新增全域未處理例外中間件並傳回標準ProblemDetails回應
   • 設定主機
   • 配置
     • 從appsettings.{environment}.json和IConfiguration介面讀取配置
     • 選擇權模式
       • 使用IOptions<T>介面將配置綁定到強類型 C# POCO
       • 使用IOptionsSnapshot<T>或IOptionsMonitor<T>介面將可在執行時間重新載入到強型別 C# POCO 的設定綁定
   • 了解HttpContext 、 HttpContext.Request和HttpContext.Response
   • 屬性路由
     • 使用Route屬性將多個路由綁定到控制器
     • 使用 Route 參數將參數傳遞給操作方法
     • 動作動詞HttpGetAttribute 、 HttpPostAttribute 、 HttpPutAttribute 、 HttpPatchAttribute和HttpDeleteAttribute
   • 模型綁定
     • 模型綁定來自以下來源
       • FromQuery ：從查詢字串中取得值
       • FromRoute ：從路線資料中取得值
       • FromForm ：從發佈的表單欄位取得值
       • FromBody ：從請求正文中取得值
       • FromHeader ：從 HTTP 標頭取得值
   • 使用IActionResult<T>或ActionResult<T>處理回應
   • 使用Accept標頭處理內容協商
     • 如果Accept標頭設定為application/xml則傳送 XML 回應
     • 如果Accept標頭設定為application/json則傳送 JSON 回應
   • .NET6 API 中的版本控制
   • 處理HTTP Patch類型請求
   • 模型驗證
     • 使用資料註釋屬性
       • Compare ：驗證模型中的兩個屬性是否符合。
       • EmailAddress ：驗證屬性是否具有電子郵件格式。
       • Phone ：驗證屬性是否具有電話號碼格式。
       • Range ：驗證屬性值是否在指定範圍內。
       • RegularExpression ：驗證屬性值是否與指定的正規表示式相符。
       • Required ：驗證欄位是否不為空。
       • StringLength ：驗證字串屬性值是否未超過指定的長度限制。
       • Url ：驗證屬性是否具有 URL 格式。
     • 使用 Fluent 方法進行 FluentValidation 驗證
   • HTTP客戶端
     • 使用IHttpClientFactory.CreateClient();
     • 命名的 HttpClient
     • 類型化 HttpClient
     • 將 DelegatingHandler 新增至 HTTP 用戶端以執行通用邏輯
     • 使用 Polly 庫處理 HTTP 異常
   • 過濾器
   • 壓縮響應體
     • 使用gzip演算法添加響應壓縮
   • 全球化與本土化
   • 速率限制
     • 使用AspNetCoreRateLimit nuget 套件和記憶體提供者進行速率限制。
     • 使用AspNetCoreRateLimit和AspNetCoreRateLimit.Redis nuget 套件與 Azure Cache for Redis 提供者進行速率限制。
   • 記錄
     • 了解日誌級別
     • 使用ILogger<T>擴充方法進行日誌記錄
       • logger.LogTrace日誌追蹤等級訊息
       • logger.LogDebug日誌偵錯等級訊息
       • logger.LogInformation日誌資訊等級訊息
       • logger.Warning日誌警告等級訊息
       • logger.Error日誌錯誤等級訊息
       • logger.Critical記錄關鍵等級訊息
     • 使用Azure AppInsights SDK 進行日誌記錄
   • 託管服務
     • 使用IHostedService介面實現託管服務
     • 透過重寫BackgroundService類別來實現後台服務
   • 使用 Automapper nuget 套件將物件從一種類型對應到另一種類型
   • 中介者模式
     • 使用 MediatR nuget 套件實現鬆散耦合的服務
   • 昂首闊步
     • 安裝Swashbuckle.AspNetCore nuget 以新增 Swagger OpenAPI 支持
     • 新增API資訊和描述
     • 新增API等級元資料的摘要標籤
     • 將OperationId 新增到群組API
     • 豐富操作元數據
     • 豐富響應元數據
     • 豐富參數元數據
     • 豐富RequestBody元數據
     • 豐富模式元數據
     • 新增標籤元數據
     • 更改 swagger 路由前綴以從根級別提供swagger.json
     • 省略 API 以在 Swagger 中可見
     • 產生多個 Swagger 文檔
   • 健康檢查

3. ASP.NET 6 API 應用程式中的資料存取

   • 使用 Micro ORM Dapper 和 PostgreSQL 進行資料訪問

     • 安裝 Npgsql
     • 安裝 Dapper Micro ORM
     • 安裝 Azure 資料工作室
     • 配置 Azure 資料庫 PostgreSQL
     • 使用 Dapper MicroORM 公開 CRUD API，公開以下端點
       • 偏移分頁/api/Persons?page=1&limit=10
       • 鍵集分頁/api/Persons?searchAfter=4499b79a-c710-45e4-ba87-083d22c4d6ad_2023-04-17T12:00:25&limit=10
       • 透過 id /api/Persons/b1333cad-9d7c-4a64-8823-db8c9aa55646取得單身
       • 建立/api/Persons
       • 更新/api/Persons/b1333cad-9d7c-4a64-8823-db8c9aa55646
       • 刪除/api/Persons/b1333cad-9d7c-4a64-8823-db8c9aa55646

   • 使用 EF Core 6 ORM 和 PostgreSQL 進行資料存取

     • 安裝 EF Core 6
     • 安裝 Azure 資料工作室
     • 配置 Azure 資料庫 PostgreSQL
     • 將DbSet<T>加入資料庫中的模型表
     • 分析DbContext
     • 使用 DbContext 擴充方法建立儲存庫模式
     • 新增配置，為資料庫表新增約束
     • 新增種子數據
     • 使用 EF Core 遷移腳本和idempotent選項新增遷移
     • 使用 EF Core ORM 公開 CRUD API，公開以下端點
       • 偏移分頁/api/Employees?page=1&limit=10
       • 鍵集分頁/api/Employees?searchAfter=4499b79a-c710-45e4-ba87-083d22c4d6ad_2023-04-17T12:00:25&limit=10
       • 透過 id /api/Employees/b1333cad-9d7c-4a64-8823-db8c9aa55646取得單身
       • 創建/api/Employees
       • 更新/api/Employees/b1333cad-9d7c-4a64-8823-db8c9aa55646
       • 刪除/api/Employees/b1333cad-9d7c-4a64-8823-db8c9aa55646

4. ASP.NET 6 API 應用程式中的回應緩存

   • 使用IMemoryCache添加記憶體緩存
   • 使用 Azure Cache for Redis 和StackExchange.Redis新增分散式快取

5. ASP.NET 6 API 應用程式的安全性

   • 新增身份驗證

     • 了解Claim , ClaimsIdentity和ClaimsPrincipal
     • 實施基本身份驗證
     • 實施 Cookie 身份驗證
     • 實施 JWT 身份驗證（自訂）
       • 使用 BCrypt 演算法和BCrypt.Net-Next nuget 對純文字密碼進行雜湊處理
       • 使用System.IdentityModel.Tokens.Jwt產生 JWT
       • 新增以下 API
         • /api/Account/Register用戶
         • /api/Account/Login用於登入使用者並產生一組初始存取權杖和刷新令牌
         • /api/Account/Token使用發送的刷新令牌刷新存取令牌
         • /api/Account/Revoke撤銷刷新令牌

   • 新增授權

     • 實施基於角色的授權
     • 實施基於策略的授權
       • 了解策略「要求」並實作IAuthorizationRequirement接口
       • 重寫HandleRequirementAsync以製定自訂策略要求
       • 在Program.cs中註冊自訂需求

   • 案例研究：使用 Auth0 新增 JWT 身份驗證和角色授權

     • 了解 OAuth2
     • 了解 OAuth2 術語
     • 了解 OAuth 流程
       • 隱式流
       • 用戶端憑證流程
       • 授權碼流程
     • 在 Auth0 中建立應用程式
     • 在 Auth0 中設定重定向 URL
     • 使用 Auth0 保護所有 API 端點
     • 定義API權限並進行策略授權

6. 處理文件上傳和文件下載

   • 文件上傳
     • 處理上傳單一或多個文件
     • 將上傳的檔案本機儲存在wwwroot folder中
     • 將上傳的檔案儲存在 Azure Blob 儲存容器中
   • 文件下載
     • 將 CSV 檔案串流傳輸到回應
     • 將 Excel .xlsx檔案串流傳輸到回應

7. 測試

   • 單元測試

     • 使用xUnit.net新增單元測試
     • 理解[Fact]和[Theory]
     • 使用構造函數初始化測試數據
     • 使用Dispose方法清理測試數據
     • 建立參數化測試
       • 使用[InlineData]傳遞原始參數
       • 使用[MemberData]傳遞原始參數和複雜參數
       • 使用[ClassData]傳遞原始參數和複雜參數
     • 使用IClassFixture在同一類別中共享測試上下文
     • 使用ICollectionFixture在多個類別之間共用測試上下文
     • 使用Moq模擬依賴服務
     • 使用Verify()或VerifyAll()驗證是否呼叫了模擬服務

   • 整合測試

     • 透過繼承WebApplicationFactory<TStartup>建立自訂Web應用程式工廠
     • 使用 EF Core 記憶體資料庫進行整合測試
     • 使用xUnit.net編寫 API 整合測試

8. 使用 gRPC 和 HTTP2 的同步服務間通信

   • 使用 gRPC 建構相互同步通訊的網關 API 和內部 API

9. 使用訊息隊列的非同步服務間通信

   • 建構使用 Azure 服務匯流排相互非同步通訊的網關 API 和內部 API（Azure 函數）。

10. 託管 ASP.NET 6 API 應用程式

    • 使用 IIS 和資料夾發布託管 ASP.NET 6 API 應用程式
    • 使用 Azure 應用程式服務託管 ASP.NET 6 API 應用程式並手動發布