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 应用程序并手动发布