FastEndpoints：轻量级、高性能的ASP.NET Core Web API开发框架

2024-06-19码农

对于在.Net中搭建API系统，我们一般是使用MVC的模式。但随着功能越来越多，控制器会越来越臃肿。

而FastEndpoints就为我们提供一种更加灵活、轻便的Web API处理方式，可以将每个控制器方法的垂直切割。

项目简介

FastEndpoints是基于REPR设计模式（请求-端点-响应）的Web API框架，它旨在减少开发代码量，提升开发效率。

与传统的ASP.NET Core Web API相比，FastEndpoints通过内联处理程序和直接的数据访问，大大简化了开发流程。

该框架不仅支持中间件、认证、授权、日志和依赖注入等常用功能，而且在性能上表现优异，性能与Minimal API不相上下。它比我们的基准测试中的MVC控制器更快，使用更少的内存，每秒处理大约35k个请求。

FastEndpoints可以很好的替换Minimal API和MVC。

框架核心功能

1、职场在多个类文件中定义端点（即使在深度嵌套的文件夹中）

2、端点可自动发现和注册

3、支持无属性的端点定义（无属性参数类型限制）

4、默认安全并支持大多数认证提供商

5、内置支持JWT Bearer认证方案

6、支持基于策略/权限/角色/声明的安全性

7、声明性安全策略构建（在每个端点内）

8、支持任何与ASP.NET兼容的IOC容器

9、端点依赖项的构造函数和属性注入

10、从路由/查询/JSON体/声明/表单/头信息中轻松绑定模型

11、支持对请求/响应DTO的Json源代码生成器

12、简易的文件处理（multipart/form-data）

13、使用FluentValidation规则的模型验证

14、方便的业务逻辑验证和错误响应

15、可快速访问环境和配置设置

16、API版本控制

17、速率限制

18、支持响应缓存

19、进程内发布/订阅事件通知（带自动发现）

20、用于实时数据流的简易服务器发送事件

21、方便的集成测试（无路由且强类型）

22、内置未捕获异常处理程序

23、支持swagger/serilog等

24、 Visual Studio扩展（vsix），用于简单的垂直切片功能脚手架

25、与ASP.NET中间件管道支持良好

26、以及Minimal APIs可以做的任何其他事情...

使用方法

1、安装并初始化

dotnet new web -n MyWebAppcd MyWebAppdotnet add package FastEndpoints

2、项目启动

修改Program.cs，完整代码如下：

using FastEndpoints;var bld = WebApplication.CreateBuilder();bld.Services.AddFastEndpoints();var app = bld.Build();app.UseFastEndpoints();app.Run();

3、定义请求和返回对象DTO

namespace MyWebApp.DTO{ public class UserRequest { public string FirstName { get; set; } public string LastName { get; set; } public int Age { get; set; } }}namespace MyWebApp.DTO{ public class UserResponse { public string FullName { get; set; } public bool IsOver18 { get; set; } }}

4、定义端点并实现业务

using FastEndpoints;using MyWebApp.DTO;namespace MyWebApp.Endpoint{ public class UserEndpoint : Endpoint<UserRequest, UserResponse> { public override void Configure(){ Post("/api/user/create"); AllowAnonymous(); } public override async Task HandleAsync(UserRequest req, CancellationToken ct){ await SendAsync(new() { FullName = req.FirstName + " " + req.LastName, IsOver18 = req.Age > 18 }); } }}