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 设置为 [启动项目] 并运行迁移