ProWebAPI

本文檔詳細介紹了使用 ProWebAPI 實現健全且標準化的 ASP.NET Core API。它涵蓋了 Swagger 整合、相依性注入、標準化回應、版本控制、請求驗證、OData v4 支援、全域異常處理以及具有 UnitOfWork 的 EF Core 等關鍵方面。該指南提供了每個組件的逐步說明。

專業WebAPI

具有所有適當標準的 ASP.NET Core API

執行標準

昂首闊步

安裝招搖

設定DI

API 的標準回應

標準反應

版本控制

安裝Nuget庫

新增到依賴容器

根據需要裝飾控制器

請求驗證器

安裝Nuget庫

在 DI 上註冊驗證器

在「RequestDto」命名空間上，新增驗證器以及 dto

建置驗證過濾器

註冊過濾器並關閉[ApiController] auto 400 Bad Request攔截

應用程式設定.json

配置資料庫的應用程式設定

建立 2 個環境配置

OData v4

支援 OData 安裝 NuGetpackages

新增到 OData 的服務 DI

配置 OData

使用 [EnableOData] 覆寫 [EnableQuery] 屬性以擷取錯誤並傳回標準回應

裝飾動作方法

透過網址查詢

全域異常處理程序

建立中介軟體

為應用程式建構器建立擴充方法

註冊中介軟體

響應套管

允許成員大小寫（props 為 pascal 大小寫），以便 OData 查詢結果不會與大小寫衝突

EF Core + 工作單元

新增支援類別庫

在 ProWeb.Data 上安裝所需的套件

運行遷移

將 ProWeb.Data 設定為 [啟動專案] 並執行遷移